CHFN(5) COMMAND REFERENCE CHFN(5) NAME chfn - definitions for password file gecos field contents SYNOPSIS /usr/lib/chfn DESCRIPTION The chfn file is a collection of regular expressions that are used by the chfn(1) utility to check for legal input while updating the password file gecos field. They specify the order for the entries and restrict input for each section of the field. The this file is used one line at a time by chfn(1) first to produce the prompt string for the entry and then to check the user's input. Line format is: [!][prompt_string];[regular_expr [ | regular_expr ]...] The prompt_string is the prompt to be issued for this portion of the gecos field. Example entries should be included here. The current content of the sub-field is printed following this prompt string. If the first character of the prompt string is "!" that sub-field can be changed only by a person logged in as root. It will be skipped in chfn(1) calls for any other user. If restricted sub-fields exist, placing them at the end of the gecos field will enhance execution speed. There is no "and" condition and if the beginning of the line and the end of the line are significant they must be included in the pattern. If no pattern exists any input will be accepted. The "or" construct has beed added to enhance the restricted environment of regular expressions. If "|" is used the patterns specified are checked in order. The first match stops the scan. EXAMPLES The following is an example file. It prompts for a name and accepts any input; then asks for a work phone and checks for a number of the form XXX-XXXX; delivery station is requested next and a number for mail delivery is requested; the user is then asked for a home phone number and its form checked; finally, if the user is super user the home machine entry is requested. Note that all patterns include start of line and end of line indications. Name; Work Phone (Example: 555-1212);^[1-9][0-9][0-9]-[0-9][0-9][0-9][0-9]$ Printed 5/12/88 1
CHFN(5) COMMAND REFERENCE CHFN(5) Delivery Station (Example: 77-215);^[Y0-9][0-9]-[0-9][0-9][0-9]$ Home Phone;^[1-9][0-9][0-9]-[0-9][0-9][0-9][0-9]$ !Home Machine (Example: tekecs);^tektronix$|^tekecs$|^gumby$ FILES /usr/lib/chfn CAVEATS If you are reading this page prior to the manual page for chfn(1) it won't make much sense. Regular expressions must be legal or changes will not be accepted. No attempt is made to check the existing password file entries for correctness, e.g. changes made with vipw(8) are not verified. This file allows local modification of the restrictions placed on users for access to the password file, it helps avoid mistakes. It does not stop the super user from making changes outside the chfn(1) utility. If changes are made to existing passwd(5) sequences the prompts will be unrelated to the existing values until all users have updated their information. Additions to the end are the easiest to make. Changes to the information stored here also affects finger(1n) output and must be coordinated with the expected information there. SEE ALSO chfn(1), finger(1n), passwd(5), and vipw(8). Printed 5/12/88 2
%%index%% na:240,109; sy:349,239; de:588,1680; ex:2268,676;3256,207; fi:3463,96; ca:3559,1055; se:4614,201; %%index%%000000000131