passgen Configuration File

Section: File Formats (5)
Index Return to Main Contents

NAME

passgen.conf - The configuration file for the CryptNET password candidate generator.

SYNOPSIS

/etc/passgen.conf

DESCRIPTION

The passgen.conf configuration file is read when the passgen program is executed, if in exists. Usually, it is stored in the /etc directory, but could be stored elsewere. If the file is stored in a location other than the default, that location must be explicitly defined at compile time.

All of the options that passgen accepts on the command line may have default values set for them in the configuration file. In the configuration file, lines beginning with a '#' character are ignored as comments. Blank lines are ignored. The configuration options are space delimited in a "key value" format where the key is the variable name in the source code and the value is what the program will set that variable to. Restrictions on length or format are specified as a comment directly above the variable definition line.

The configuration file is distributed with all values set to the program defaults and commented out. To change a value, the line defining the variable in the configuration file should be uncommented and an acceptable alternative value should be set.

The following variables can be set in the configuration file:

num_chars

Specifies the length of the passwords to be generated.

num_passwds

Specifies the number of passwords to be generated.

use_urandom

Use the non-blocking /dev/urandom device to speed password candidate generation. (0 = No, 1 = Yes)

no_space

Exclude the space character from generated password candidates. (0 = No, 1 = Yes)

passwd_type

Generate password candidates consisting of the following:

: 0 - All printable characters.

: 1 - Alpha numeric characters only.

: 2 - Alphabetic characters only.

: 3 - Numeric characters only.

forced_case

For alphabetic characters, force the characters to a specific case.

: 0 - Do not force case (mixed case).

: 1 - Force all alphabetic characters to lowercase.

: 2 - Force all alphabetic characters to uppercase.

homoglyph_supression_level

The level homoglyphs (similar looking characters) should be suppressed.

: 0 - No homoglyph suppression.

: 1 - Suppress font homoglyphs such as zero, capital 'o' (Oscar), one, and lowercase 'l' (Lema).

: 2 - Suppress font homoglyphs and potential character homoglyphs such as backtick, apostrophe, double quote, space, and underbar.

BUGS

There are no known bugs.