From 7945911088216fafe4d377816e7bbbb17d8a0aa7 Mon Sep 17 00:00:00 2001 From: Oliver Tappe Date: Tue, 3 Apr 2007 18:33:49 +0000 Subject: * even more work on consolidating the PODs. Hopefully, I'm finished now... git-svn-id: http://svn.openslx.org/svn/openslx/trunk@858 95ad53e4-c205-0410-b2fa-d234c58c8868 --- config-db/slxsettings | 102 ++++++++++++++++++++++++++++---------------------- 1 file changed, 58 insertions(+), 44 deletions(-) (limited to 'config-db/slxsettings') diff --git a/config-db/slxsettings b/config-db/slxsettings index 0189123e..4a57307c 100755 --- a/config-db/slxsettings +++ b/config-db/slxsettings @@ -157,13 +157,10 @@ slxsettings - OpenSLX-script to show & change local settings =head1 SYNOPSIS -slxsettings [options] +slxsettings [options] [action ...] - Script Options: - --quiet do not print anything - --remove= remove given key from settings +=head3 OpenSLX Options - OpenSLX Options: --base-path= basic path to project files --bin-path= path to binaries and scripts --config-path= path to configuration files @@ -182,137 +179,152 @@ slxsettings [options] --tftpboot-path= path to root of tftp-server --verbose-level= level of logging verbosity (0-3) - General Options: +=head3 General Options + --help brief help message --man full documentation + --quiet do not print anything --verbose show more information --version show version -=head1 OPTIONS - -=head3 Script Options +=head3 Actions =over 8 -=item B<--quiet> +=item B<< = >> -Runs the script without printing anything. +sets the specified openslx-option (without the leading '--') to the given value -=item B<--remove=> +=item B<< remove= >> -Removes given key from settings (apply more than once to remove several keys). +removes given openslx-option (sets it to an empty string) -=item B<--verbose> - -Prints the resulting settings after changes have been applied. =back +=head1 DESCRIPTION + +B can be used to show or change the local settings for OpenSLX. + +Any cmdline-argument passed to this script will change the local OpenSLX +settings file (usually /etc/opt/openslx/settings.local). + +If you invoke the script without any arguments, it will print the current +settings and exit. + +=head1 OPTIONS + =head3 OpenSLX Options =over 8 -=item B<--base-path=> +=item B<< --base-path= >> Sets basic path to project files. Default is $SLX_BASE_PATH (usually F). -=item B<--bin-path=> +=item B<< --bin-path= >> Sets path to binaries and scripts. Default is $SLX_BASE_PATH/bin (usually F). -=item B<--config-path=> +=item B<< --config-path= >> Sets path to configuration files. Default is $SLX_CONFIG_PATH (usually F). -=item B<--db-basepath=> +=item B<< --db-basepath= >> Sets basic path to openslx database. Default is $SLX_DB_PATH (usually F). -=item B<--db-datadir=> +=item B<< --db-datadir= >> Sets data folder created under db-basepath. Default is $SLX_DB_DATADIR (usually empty as it depends on db-type whether or not such a directory is required at all). -=item B<--db-name=> +=item B<< --db-name= >> Gives the name of the database to connect to. Default is $SLX_DB_NAME (usually C). -=item B<--db-spec=> +=item B<< --db-spec= >> Gives the full DBI-specification of database to connect to. Content depends on the db-type. Default is $SLX_DB_SPEC (usually empty as it will be built automatically). -=item B<--db-type=> +=item B<< --db-type= >> Sets the type of database to connect to (CSV, SQLite, mysql, ...). Default $SLX_DB_TYPE (usually C). -=item B<--export-path=> +=item B<< --export-path= >> Sets path to root of all exported filesystems. For each type of export (NFS, NBD, ...) a separate folder will be created in here. Default is $SLX_EXPORT_PATH (usually F. -=item B<--locale=> +=item B<< --locale= >> Sets the locale to use for translations. Defaults to the system's standard locale. -=item B<--logfile=> +=item B<< --logfile= >> Specifies a file where logging output will be written to. Default is to log to STDERR. -=item B<--private-path=> +=item B<< --private-path= >> Sets path to private data, where the config-db, vendor_oses and configurational extensions will be stored. Default is $SLX_PRIVATE_PATH (usually F. -=item B<--public-path=> +=item B<< --public-path= >> Sets path to public (client-accesible) data. Default is $SLX_PUBLIC_PATH (usually F. -=item B<--share-path=> +=item B<< --share-path= >> Sets path to sharable data, where distro-specs and functionality templates will be stored. Default is $SLX_SHARE_PATH (usually F. -=item B<--temp-path=> +=item B<< --stage1-path= >> + +Sets path to stage1 systems, where distributor-systems will be installed. + +Default is $SLX_STAGE1_PATH (usually F. + +=item B<< --temp-path= >> Sets path to temporary data. Default is $SLX_TEMP_PATH (usually F. -=item B<--tftpboot-path=> +=item B<< --tftpboot-path= >> Sets path to root of tftp-server from which clients will access their files. Default is $SLX_TFTPBOOT_PATH (usually F. -=item B<--verbose-level=> +=item B<< --verbose-level= >> Sets the level of logging verbosity (0-3). @@ -324,26 +336,28 @@ Default is $SLX_VERBOSE_LEVEL (usually 0, no logging). =over 8 -=item B<--help> +=item B< --help> Prints a brief help message and exits. -=item B<--man> +=item B< --man> Prints the manual page and exits. -=item B<--version> +=item B< --quiet> -Prints the version and exits. +Runs the script without printing anything. -=back +=item B< --verbose> -=head1 DESCRIPTION +Prints the resulting settings after changes have been applied. -B can be used to show or change the local settings for OpenSLX. +=item B< --version> -Any cmdline-argument passed to this script will change the local OpenSLX -settings file (usually /etc/opt/openslx/settings.local). +Prints the version and exits. -If you invoke the script without any arguments, it will print the current -settings and exit. +=back + +=head1 SEE ALSO + +slxos-setup, slxos-export, slxconfig, slxconfig-demuxer \ No newline at end of file -- cgit v1.2.3-55-g7522