From db60e20ca7a328509da99862a1634639dd45cf5d Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Wed, 7 Nov 2012 13:05:47 -0600 Subject: man: Migrate generate-manpages.bash to sphinx Signed-off-by: Sol Jerome --- tools/manpagegen/bcfg2.1.ronn | 158 ------------------------------------------ 1 file changed, 158 deletions(-) delete mode 100644 tools/manpagegen/bcfg2.1.ronn (limited to 'tools/manpagegen/bcfg2.1.ronn') diff --git a/tools/manpagegen/bcfg2.1.ronn b/tools/manpagegen/bcfg2.1.ronn deleted file mode 100644 index 8b3ea1e60..000000000 --- a/tools/manpagegen/bcfg2.1.ronn +++ /dev/null @@ -1,158 +0,0 @@ -bcfg2(1) -- Bcfg2 client tool -============================= - -## SYNOPSIS - -`bcfg2` [_options_][_..._] - -## DESCRIPTION - -`bcfg2` runs the Bcfg2 configuration process on the current host. This -process consists of the following steps. - -* Fetch and execute probes -* Upload probe results -* Fetch the client configuration -* Check the current client state -* Attempt to install the desired configuration -* Upload statistics about the Bcfg2 execution and client state - -## OPTIONS - - * `-B`: - Configure everything except the given bundle(s). - - * `-C` : - Specify alternate bcfg2.conf location. - - * `-D` [,]: - Specify a set of Bcfg2 tool drivers. - - *NOTE: only drivers listed will be loaded. (e.g., if you do not - include POSIX, you will be unable to verify/install Path entries).* - - * `-E` : - Specify the encoding of Cfg files. - - * `-I`: - Run bcfg2 in interactive mode. The user will be prompted before - each change. - - * `-O`: - Omit lock check. - - * `-P`: - Run bcfg2 in paranoid mode. Diffs will be logged for configuration - files marked as paranoid by the Bcfg2 server. - - * `-R` : - Specify the number of times that the client will attempt to retry - network communication. - - * `-S` : - Manually specify the server location (as opposed to using the value - in bcfg2.conf). - - * `-Z`: - Do not configure independent entries. - - * `-b` [_bundle1:bundle2_]: - Run bcfg2 against one or multiple bundles in the configuration. - - * `-c` : - Cache a copy of the configuration in cachefile. - - * `--ca-cert=`: - Specifiy the path to the SSL CA certificate. - - * `-d`: - Run bcfg2 in debug mode. - - * `-e`: - When in verbose mode, display extra entry information (temporary - until verbosity rework). - - * `-f` : - Configure from a file rather than querying the server. - - * `-h`: - Print Usage information. - - * `-k`: - Run in bulletproof mode. This currently only affects behavior in - the debian toolset; it calls apt-get update and clean and dpkg - --configure --pending. - - * `-l` : - Run the client in the server decision list mode (unless "none" - is specified, which can be done in order to override the decision - list mode specified in bcfg2.conf). This approach is needed when - particular changes are deemed "high risk". It gives the ability to - centrally specify these changes, but only install them on clients - when administrator supervision is available. Because collaborative - configuration is one of the remaining hard issues in configuration - management, these issues typically crop up in environments with - several administrators and much configuration variety. (This setting - will be ignored if the -f option is also specified). - - * `-n`: - Run bcfg2 in dry-run mode. No changes will be made to the system. - - * `-o` : - Writes a log to the specified path. - - * `-p` : - Assert a profile for the current client. - - * `-q`: - Run bcfg2 in quick mode. Package checksum verification won’t be - performed. This mode relaxes the constraints of correctness, and - thus should only be used in safe conditions. - - * `-Q`: - Run bcfg2 in "bundle quick" mode, where only entries in a bundle are - verified or installed. This runs much faster than -q, but doesn’t - provide statistics to the server at all. In order for this option to - work, the -b option must also be provided. This option is incompatible - with -r. - - * `-r` : - Cause bcfg2 to remove extra configuration elements it detects. Mode is - one of all, Services, or Packages. All removes all entries. Likewise, - Services and Packages remove only the extra configuration elements - of the respective type. - - * `-s` : - Set bcfg2 interaction level for services. Default behavior is to - modify all services affected by reconfiguration. build mode attempts - to stop all services started. disabled suppresses all attempts to - modify services. - - * `--ssl-cert=`: - Specifiy the path to the SSL certificate. - - * `--ssl-cns=`[_CN1:CN2_]: - List of acceptable SSL server Common Names. - - * `--ssl-key=`: - Specifiy the path to the SSL key. - - * `-u` : - Attempt to authenticate as ’user’. - - * `-x` : - Use ’password’ for client communication. - - * `-t` : - Set the timeout (in seconds) for client communication. Default is - 90 seconds. - - * `-v`: - Run bcfg2 in verbose mode. - - * `-z`: - Only configure independent entries, ignore bundles. - -## SEE ALSO - -bcfg2-server(8), bcfg2-info(8) -- cgit v1.2.3-1-g7c22