3. Invoking sort-pw-cfg

This program will sort (and merge) the per-domain password attributes. If there are duplicate entries, the last entry seen will survive. The result will be sorted by password id hash code and option name. Thus, any file containing more recent entries should appear last. If you have updated two different password ids in two different password configuration files without having merged them, you may have a merge problem. You will need to try to remember what you did.

The "header" portion of the config file (the seeds and the <program...> marker) are taken from the first config file listed and ignored in the remaining files.

Example usage can be seen in the example section below.

This chapter was generated by AutoGen, using the agtexi-cmd template and the option descriptions for the sort-pw-cfg program.

3.1 sort-pw-cfg help/usage (‘--help’)

This is the automatically generated usage text for sort-pw-cfg.

The text printed is the same whether selected with the help option (‘--help’) or the more-help option (‘--more-help’). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is used to select the program, defaulting to ‘more’. Both will exit with a status code of 0.

sort-pw-cfg - sort/merge password config file - Ver. 2.3.2
Usage:  sort-pw-cfg [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
                [ <cfg-file> ...]
  Flg Arg Option-Name    Description
   -o Fil output         send result to this file
   -d no  default        select default config file for first input file
   -v opt version        output version information and exit
   -h no  help           display extended usage information and exit
   -M no  more-help      extended usage information passed thru pager

Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.

If no arguments are provided, input arguments are read from stdin,
one per line; blank and '#'-prefixed lines are comments.
'stdin' may not be a terminal (tty).

This program will sort (and merge) the per-domain password attributes.  If
there are duplicate entries, the last entry seen will survive.  The result
will be sorted by password id hash code and option name.  Thus, any file
containing more recent entries should appear last.  If you have updated two
different password ids in two different password configuration files
without having merged them, you may have a merge problem.  You will need to
try to remember what you did.

The "header" portion of the config file (the seeds and the <program...>
marker) are taken from the first config file listed and ignored in the
remaining files.

3.2 output option (-o)

This is the “send result to this file” option. This option takes a file argument. Normally, the first named file is rewritten with the entries ordered by the hash code with duplicates removed. Use this option to redirect output to the named file.

3.3 default option (-d)

This is the “select default config file for first input file” option. Instead of starting with the first operand (or first file in the standard input file list), start processing password id’s with the contents of the standard configuration file. The additional files will override or augment this file.

3.4 sort-pw-cfg exit status

One of the following exit values will be returned:

‘0 (EXIT_SUCCESS)’

Successful program execution.

‘1 (EXIT_INVALID)’

the option/argument configuration is invalid

‘2 (EXIT_NO_MEM)’

insufficient memory

‘3 (EXIT_BAD_USER)’

no password entry for current user

‘4 (EXIT_HOMELESS)’

home directory could not be found

‘5 (EXIT_PERM)’

config file improperly protected

‘6 (EXIT_NO_CONFIG)’

config file missing

‘7 (EXIT_BAD_CONFIG)’

cannot update config file

‘8 (EXIT_NO_SEED)’

no seeds were specified in the config file

‘9 (EXIT_BAD_SEED)’

The seed value was invalid

‘10 (EXIT_BAD_SELECT_CHARS)’

the list of characters for the –select-chars option is bad

‘11 (EXIT_NO_PWID)’

no password id was specified

‘16 (EXIT_CODING_ERROR)’

There is a coding error that should be reported

3.5 sort-pw-cfg Authors

Written by Bruce Korb.

This document was generated by Bruce Korb on June 30, 2018 using texi2html 1.82.