diff --git a/sbin/ngcp-network b/sbin/ngcp-network index 3868b077..e70adfce 100755 --- a/sbin/ngcp-network +++ b/sbin/ngcp-network @@ -580,36 +580,43 @@ close $fh or croak "Couldn't close '$fh': $OS_ERROR"; __END__ =head1 NAME + ngcp-network - command line interface to ngcp's network configuration settings =head1 SYNOPSIS -ngcp-network + +B [I...] + +=head1 DESCRIPTION + +B will read the given input file(s) and do something +useful with the contents thereof. =head1 OPTIONS =over 8 -=item B<--advertised-ip=> +=item B<--advertised-ip=>I Set advertised_ip configuration to specified argument. -=item B<--bond-miimon=> +=item B<--bond-miimon=>I Set bond_miimon configuration to specified argument. -=item B<--bond-mode=> +=item B<--bond-mode=>I Set bond_mode configuration to specified argument. -=item B<--bond-slaves=> +=item B<--bond-slaves=>I Set bond_slaves configuration to specified argument. -=item B<--broadcast=> +=item B<--broadcast=>I Set broadcast configuration to specified argument. -=item B<--clone-from=> +=item B<--clone-from=>I Clone specified HOST section, using specified HOST setting as its source. Please do not forget to manually adjust the resulting configuration file, no @@ -621,106 +628,98 @@ web/db/proxy/.... systems, where the host definition of a host like 'prx01a' should be used as base for another host 'prx02a'. Usage example: '--clone-from=prx01a --clone-to=prx02a' -=item B<--clone-to=> +=item B<--clone-to=>I Clone specified HOST section, using specified HOST setting as its destination. Refer to '--clone-from=' for further information. -=item B<--dbnode=> +=item B<--dbnode=>I Set dbnode configuration to specified number argument. If no value is provide it will use the next value available ( max + 1 ) -=item B<--dns=> +=item B<--dns=>I Set dns_nameservers configuration to specified argument. Can be specified multiple times in one single command line. -=item B<--gateway=> +=item B<--gateway=>I Set gateway configuration to specified argument. -=item B<--help> - -Print the help message and exit. - -=item B<--host=> +=item B<--host=>I Apply configuration changes for specified host entry instead of using the hostname of the currently running system. NOTE: If running the sip:provider CE edition this configuration option can't be changed as the only configured host is set to and supposed to be 'self' there. -=item B<--hwaddr=> +=item B<--hwaddr=>I Set hwaddr configuration (MAC address of network device) to specified argument. -=item B<--input-file=> +=item B<--input-file=>I Use specified file as input, defaults to /etc/ngcp-config/network.yml if unset. -=item B<--internal-iface=> +=item B<--internal-iface=>I Set internal-iface configuration to specified argument. -=item B<--ip=> +=item B<--ip=>I Set ip configuration (IPv4 address) to specified argument. If set to 'auto' and the selected interface is available on the running host then the IP address will be determined based on its current settings. -=item B<--ipv6=> +=item B<--ipv6=>I Set ip configuration (IPv6 address) to specified argument. If set to 'auto' and the selected interface is available on the running host then the IP address will be determined based on its current settings. -=item B<--man> - -Prints the manual page and exits. - -=item B<--move-from=> +=item B<--move-from=>I Move item from specified level (being host for --role and interface for --type). The item needs to be chosen via --type or --role. To be used in combination with --move-to=.... -=item B<--move-to=> +=item B<--move-to=>I Move item to specified level (being host for --role and interface for --type). The item needs to be chosen via --type or --role. To be used in combination with --move-to=.... -=item B<--netmask=> +=item B<--netmask=>I Set netmask configuration to specified argument. -=item B<--output-file=> +=item B<--output-file=>I Store resulting file under specified argument. If unset defaults to /etc/ngcp-config/network.yml. -=item B<--peer=> +=item B<--peer=>I Set peer configuration (being the corresponding other node in a PRO setup) to specified argument. -=item B<--remove-host=> +=item B<--remove-host=>I Remove the specified host from the configuration file. Can be specified multiple times (--remove-host=sp1 --remove-host=sp2 ...). -=item B<--remove-interface=> +=item B<--remove-interface=>I Remove the specified interface from the configuration file. Can be specified multiple times (--remove-interface=eth5 --remove-interface=eth6 ...). -=item B<--role=> +=item B<--role=>I Set role configuration for host to specified argument. Can be specified multiple times (--role=lb --role=proxy ...). -=item B<--set-interface=> +=item B<--set-interface=>I Add specified network interface. Can be combined with options like --hwaddr, --ip, --netmask,... to set specified arguments as configuration options for the @@ -732,19 +731,23 @@ options like --hwaddr can't be sanely combined with different settings on multiple interfaces. Instead invoke ngcp-network with the --set-interface option mulitple times. -=item B<--shared-ip=> +=item B<--shared-ip=>I Set shared_ip configuration to specified argument. -=item B<--shared-ipv6=> +=item B<--shared-ipv6=>I Set shared_v6ip configuration to specified argument. -=item B<--type=> +=item B<--type=>I Set type configuration to specified argument. Can be specified multiple times in one single command line. +=item B<--vlan-raw-device=>I + +Set vlan_raw_device configuration to specified argument. + =item B<--verbose> Be more verbose about execution. @@ -753,16 +756,15 @@ Be more verbose about execution. Display program version and exit. -=item B<--vlan-raw-device=> +=item B<--man> -Set vlan_raw_device configuration to specified argument. +Prints the manual page and exits. -=back +=item B<--help> -=head1 DESCRIPTION +Print the help message and exit. -B will read the given input file(s) and do something -useful with the contents thereof. +=back =head1 USAGE @@ -877,15 +879,6 @@ Exit code 9 means the specified argument to a command line option is not valid. There's no configuration file for the ngcp-network script itself supported at the moment. The main configuration file ngcp-network operates on is /etc/ngcp-config/network.yml. -=head1 DEPENDENCIES - -ngcp-network relies on a bunch of Perl modules, all of them specified as dependencies -through the ngcp-ngcpcfg Debian package. - -=head1 INCOMPATIBILITIES - -No known at this time. - =head1 BUGS AND LIMITATIONS Please report problems you notice to the Sipwise Development Team . @@ -894,7 +887,7 @@ Please report problems you notice to the Sipwise Development Team -=head1 LICENSE AND COPYRIGHT +=head1 LICENSE GPL-3+, Sipwise GmbH, Austria diff --git a/sbin/ngcp-sync-constants b/sbin/ngcp-sync-constants index 5356d397..ffc13988 100755 --- a/sbin/ngcp-sync-constants +++ b/sbin/ngcp-sync-constants @@ -339,35 +339,40 @@ __END__ ngcp-sync-constants - syncronizes passwords from constants.yml with MySQL -=head1 USAGE +=head1 SYNOPSIS -ngcp-sync-constants [ options ... ] +B [I...] + +=head1 DESCRIPTION + +B reads constants.yml file, parses it and syncronizes all +required passwords with MySQL. =head1 OPTIONS =over 8 =item B<--root> + Use mysql root user without password as DB credentials =item B<--init-passwords> + New passwords are generated (passwords for "mysql" is not generated to avoid replication problems) =item B<--test> + No real updates, only for checks =item B<--verbose> -Verbose mode where all changes are written to STDOUT - -=back -=head1 REQUIRED ARGUMENTS +Verbose mode where all changes are written to STDOUT -None +=item B<--help> -=head1 DESCRIPTION +Print this help message. -B reads constants.yml file, parses it and syncronizes all required passwords with MySQL +=back =head1 EXIT STATUS @@ -385,19 +390,10 @@ Something is wrong, an error message raises TODO -=head1 DEPENDENCIES - -ngcp-sync-constants relies on a bunch of Perl modules, all of them specified as -dependencies through the Debian package. - =head1 CONFIGURATION /etc/ngcp-config/constants.yml -=head1 INCOMPATIBILITIES - -No known at this time. - =head1 BUGS AND LIMITATIONS Please report problems you notice to the Sipwise Development Team . @@ -406,7 +402,7 @@ Please report problems you notice to the Sipwise Development Team -=head1 LICENSE AND COPYRIGHT +=head1 LICENSE Copyright (C) 2016 Sipwise GmbH, Austria diff --git a/sbin/ngcp-sync-grants b/sbin/ngcp-sync-grants index f3c0389b..12cfa07b 100755 --- a/sbin/ngcp-sync-grants +++ b/sbin/ngcp-sync-grants @@ -536,9 +536,13 @@ __END__ ngcp-sync-grants - synchronizes mysql grants from a schema template -=head1 USAGE +=head1 SYNOPSIS -ngcp-sync-grants [ options ... ] +B [I...] + +=head1 DESCRIPTION + +B synchronizes mysql grants from a schema template. =head1 OPTIONS @@ -556,10 +560,6 @@ Verbose mode =back -=head1 DESCRIPTION - -B synchronizes mysql grants from a schema template. - =head1 EXIT STATUS =over 8 @@ -572,27 +572,10 @@ Something is wrong, an error message raises =back -=head1 REQUIRED ARGUMENTS - -None - -=head1 CONFIGURATION - -None - -=head1 DEPENDENCIES - -ngcp-sync-grants relies on a bunch of Perl modules, all of them specified as -dependencies through the Debian package. - =head1 DIAGNOSTICS TODO -=head1 INCOMPATIBILITIES - -No known at this time. - =head1 BUGS AND LIMITATIONS Please report problems you notice to the Sipwise @@ -602,7 +585,7 @@ Development Team . Kirill Solomko -=head1 LICENSE AND COPYRIGHT +=head1 LICENSE Copyright (C) 2016 Sipwise GmbH, Austria