Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
bpkg-cfg-info(1)	    General Commands Manual	      bpkg-cfg-info(1)

NAME
       bpkg-cfg-info - print configuration information

SYNOPSIS
       bpkg cfg-info [options]

DESCRIPTION
       The  cfg-info command prints the	current	configuration's	absolute path,
       id, type, and name. If the --link and/or	--backlink options are	speci-
       fied,  then this	information is also printed for	each linked and/or im-
       plicitly	backlinked configuration, if any. Note that the	 dangling  im-
       plicit  backlinks are silently skipped, unless --dangling is specified,
       in which	case this information is also printed for them.	Note that  the
       information is written to stdout, not stderr.

       If  the	--recursive  option  is	 specified together with --link	and/or
       --backlink, then	this information is printed for	linked and/or  implic-
       itly backlinked configuration, recursively.

       The output format is regular with each value printed on a separate line
       and  prefixed  with  the	 value name. If	the --link, --backlink,	and/or
       --dangling options are specified, then information blocks corresponding
       to linked configurations	are separated with blank lines.	For example:

       path: /path/to/cfg/
       uuid: 8d439f03-7342-4502-8b1c-74b173869478
       type: target
       name: foo

       path: /path/to/host-cfg/
       uuid: 7ee4dab3-07d9-4163-81c0-3779166a7213
       type: host
       name: tools

       path: /path/to/build2-cfg/
       uuid: d453aa2a-92c4-4066-87e4-c8672eed06e1
       type: build2
       name: modules

CFG-INFO OPTIONS
       --link Print linked configurations.

       --backlink
	      Print implicitly backlinked configurations.

       --dangling
	      Print dangling implicit backlinks.

       --recursive
	      Print linked configurations recursively.

       --directory|-d dir
	      Assume configuration is in dir rather than in the	current	 work-
	      ing directory.

COMMON OPTIONS
       The  common  options are	summarized below with a	more detailed descrip-
       tion available in bpkg-common-options(1).

       -v     Print essential underlying commands being	executed.

       -V     Print all	underlying commands being executed.

       --quiet|-q
	      Run quietly, only	printing error messages.

       --verbose level
	      Set the diagnostics verbosity to level between 0 and 6.

       --stdout-format format
	      Representation format to use for printing	to stdout.

       --jobs|-j num
	      Number of	jobs to	perform	in parallel.

       --no-result
	      Don't print informational	messages about the outcome of perform-
	      ing a command or some of its parts.

       --structured-result fmt
	      Write the	result of performing a command in a structured form.

       --progress
	      Display progress indicators for long-lasting operations, such as
	      network transfers, building, etc.

       --no-progress
	      Suppress progress	indicators for long-lasting  operations,  such
	      as network transfers, building, etc.

       --diag-color
	      Use color	in diagnostics.

       --no-diag-color
	      Don't use	color in diagnostics.

       --build path
	      The build	program	to be used to build packages.

       --build-option opt
	      Additional option	to be passed to	the build program.

       --fetch path
	      The fetch	program	to be used to download resources.

       --fetch-option opt
	      Additional option	to be passed to	the fetch program.

       --fetch-timeout sec
	      The fetch	and fetch-like (for example, git) program timeout.

       --pkg-proxy url
	      HTTP  proxy  server  to  use when	fetching package manifests and
	      archives from remote pkg repositories.

       --git path
	      The git program to be used to fetch git repositories.

       --git-option opt
	      Additional common	option to be passed to the git program.

       --sha256	path
	      The sha256 program to be used to calculate SHA256	sums.

       --sha256-option opt
	      Additional option	to be passed to	the sha256 program.

       --tar path
	      The tar program to be used to extract package archives.

       --tar-option opt
	      Additional option	to be passed to	the tar	program.

       --openssl path
	      The openssl program to be	used for crypto	operations.

       --openssl-option	opt
	      Additional option	to be passed to	the openssl program.

       --auth type
	      Types of repositories to authenticate.

       --trust fingerprint
	      Trust repository certificate with	a SHA256 fingerprint.

       --trust-yes
	      Assume the answer	to all authentication prompts is yes.

       --trust-no
	      Assume the answer	to all authentication prompts is no.

       --git-capabilities up=pc
	      Protocol capabilities (pc) for a git repository URL prefix (up).

       --pager path
	      The pager	program	to be used to show long	text.

       --pager-option opt
	      Additional option	to be passed to	the pager program.

       --options-file file
	      Read additional options from file.

       --default-options dir
	      The directory to load additional default options files from.

       --no-default-options
	      Don't load default options files.

       --keep-tmp
	      Don't remove the bpkg's temporary	directory at the  end  of  the
	      command execution	and print its path at the verbosity level 2 or
	      higher.

DEFAULT	OPTIONS	FILES
       See  bpkg-default-options-files(1)  for	an overview of the default op-
       tions files. For	the cfg-info command the search	start directory	is the
       configuration directory.	The following options files are	 searched  for
       in each directory and, if found,	loaded in the order listed:

       bpkg.options
       bpkg-cfg-info.options

       The  following  cfg-info	command	options	cannot be specified in the de-
       fault options files:

       --directory|-d

BUGS
       Send bug	reports	to the users@build2.org	mailing	list.

COPYRIGHT
       Copyright (c) 2014-2024 the build2 authors.

       Permission is granted to	copy, distribute and/or	modify	this  document
       under the terms of the MIT License.

bpkg 0.17.0			   June	2024		      bpkg-cfg-info(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bpkg-cfg-info&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help