fixmog(ADM)                     19 June 1992                     fixmog(ADM)


 Name

    fixmog, cps - make all system files consistent with the authentication
    database, make specific system files consistent with the authentication
    database

 Syntax

    /tcb/bin/fixmog [ -i ] [ -v ]

    /tcb/bin/cps [ absolutepathnames ]

 Description

    fixmog attempts to correct inconsistencies found by integrity(ADM).
    integrity traverses the File Control database and compares each entry to
    the real file in the filesystem. Each file is checked to ensure it has
    the specified owner, group, access permissions and type.  fixmog changes
    the owner, group and access permissions of files to those in the File
    Control database.  If the -i (interactive) option is used, fixmog
    requests confirmation before making any changes.  If the -v (verbose)
    option is in effect, fixmog displays a line detailing each change made.
    The -i option overrides the -v option.  If a file is of the wrong type
    (for example, a regular file when it should be a directory), a message
    giving the expected and actual types is output and no changes are made to
    that file.  If a change fails, an error message giving the change
    attempted is output.

    Like fixmog, cps is used to correct problems in the TCB.  However, cps
    checks specified files rather than all files in the File Control data-
    base.  cps is used primarily by the crash recovery script to ensure files
    critical to the TCB exist and have the correct owner, group and access
    permissions specified in the File Control database.

    cps accepts absolute pathnames of directories and files to be created.
    Absolute pathnames are complete pathnames (for example /tcb/bin/cps) as
    opposed to relative pathnames (for example ../file).  An entry (contain-
    ing a mode) for each component of each pathname must be present in the
    File Control database, otherwise a fatal error is returned.

    Each missing element of each path is created as specified in the File
    Control database. Elements of each path that already exist, but have
    incorrect owner, group or access permissions, are changed so they agree
    with their File Control database entries.

    If no parameters are supplied, the pathnames are read from the standard
    input, which should contain absolute pathnames separated by newlines.

    Only the super user can use the fixmog and cps commands.

 File

    /etc/auth/system/files  File Control database

 See also

    integrity(ADM), fixmog(ADM), tcbck(ADM)

 Diagnostics

    fixmog returns an exit status of 1 if the user attempting to run the pro-
    gram is not the superuser, invalid options were specified or the
    integrity(ADM) command could not be run: otherwise 0 is returned. Errors
    cause appropriate error messages to be displayed.

    cps returns an exit status of 1 if a fatal error was detected; otherwise
    0 is returned if no changes were required and 2 if any changes to the
    file system were made.  Errors cause appropriate error messages to be
    displayed.

 Notes

    cps converts the pathnames supplied to canonical pathnames, i.e. ones
    that don't contain consecutive ``/''s, and none of the directories are
    ``.'' or ``..''. This enables pathnames to be looked up in the File Con-
    trol database where pathnames should also be in this format.

 Value added

    fixmog and cps are an extension of AT&T System V provided by The Santa
    Cruz Operation, Inc.