aliasck(1M)                C2 Trusted DG/UX 5.4.2T               aliasck(1M)


NAME
       aliasck - check aliases

SYNOPSIS
       aliasck [-q] -a [alias-string]
       aliasck [-q] -l [alias-string]

   where:
       alias-string
              is an audit or location and time set alias string to be
              checked against the alias definition files.

DESCRIPTION
       The aliasck command validates alias definitions.  The -a option
       specifies that audit aliases be checked, and the -l option specifies
       that location and time set aliases be checked.  The aliasck -a
       command checks the contents of the audit alias definition files for
       errors.  If an optional alias-string is given, it will also check
       this alias against the files to see if it is defined and valid.  The
       aliasck -l command checks the contents of the location and time set
       (loctime) alias definition files for errors.  If an optional alias-
       string is given, it will also check this string against the files.
       For all options, if the -q option is given, the program will do its
       work silently.  In this case, no error message will be written, but
       the exit code will be set appropriately.

       The user must have appropriate privilege to invoke this command.

       See auditaliasdefs(4M) and loctimealiasdefs(4M) for details of
       the required syntax.

       The following alias errors are detected:

            Alias parsing errors:
                 name too long
                 unknown class/alias name (audit)
                 unknown location/alias name (loctime)
                 unknown reason name (audit)
                 unknown timeset name (loctime)
                 addition/subtraction of incomplete masks
                 addition of incomplete loctimes
                 bad syntax
                 internal errors (not user errors)
                      bad parse state encountered
                      reason found in class tree (audit)
                      class found in reason tree (audit)
                      timeset found in location tree (audit)
                      location found in timeset tree (audit)

            Alias name errors:
                 duplicate name
                 duplicate abbreviation

            Audit mask/loctime name definition file errors:



Licensed material--property of copyright holder(s)                         1

aliasck(1M)                C2 Trusted DG/UX 5.4.2T               aliasck(1M)


                 can't open audit_mask_defs file (audit)
                 can't open loctime_name_defs file (loctime)
                 *Reason line missing (must be first section) (audit)
                 bad reason line format (must be alphanum alphanum decimal)
                 (audit)
                 *Class line missing (must be second section) (audit)
                 bad class line format (must be alphanum alphanum decimal)
                 (audit)
                 *Timeset line missing (must be first section) (loctime)
                 bad timeset line format (loctime)
                 *Location line missing (must be second section) (loctime)
                 bad location line format (loctime)
                 bad *line encountered (if third one exists, must be
                 *General)
                 extra *line encountered (only 3 above allowed)
                 bad alias def line (must be 2 alphanums & char string)

            Alias definition file errors:
                 can't open audit_alias_defs file (audit)
                 can't open loctime_alias_defs file (loctime)
                 *line found - invalid in this file
                 bad alias def line (must be 2 alphanums & char string)

            General errors:
                 not enough memory
                 null alias-string
                 incomplete alias

       When an error is detected, an appropriate error message is written to
       the standard output (without the -q option).  If the error is a parse
       error relating to a particular alias definition, the offending
       definition is displayed with a pointer to the position where the
       error was found.  The program will stop at the first error detected.

EXAMPLES
       # aliasck -a
       In file /etc/tcb/audit/auditaliasdefs:
         (CHDIR,LINK,MKDIR,UMLINK):ALL
                           ^
         unknown class/alias name

       # aliasck -a foo
       Invalid audit mask:
         foo
         ^
         Unknown alias

FILES
       /etc/tcb/audit/auditmaskdefs  File of basic aliases for classes and
                                       reasons.

       /etc/tcb/audit/auditaliasdefs  File defining additional site-
                                        specific audit aliases.




Licensed material--property of copyright holder(s)                         2

aliasck(1M)                C2 Trusted DG/UX 5.4.2T               aliasck(1M)


       /etc/tcb/aa/loctimenamedefs  File of basic aliases for locations
                                      and time sets.

       /etc/tcb/aa/loctimealiasdefs  File defining additional site-
                                       specific loctime aliases.

DIAGNOSTICS
       Exit status is 0 if successful, 1 on error.

NOTES
       The program stops at the first detected error.  It may need to be
       executed again after each error is corrected to completely check the
       alias files.

SEE ALSO
       audadmin(1M), auditaliasdefs(4M), auditmaskdefs(4M),
       loctimealiasdefs(4M), loctimenamedefs(4M).

       Audit System Administrator's Guide for the C2 Trusted DG/UX System.
       Trusted Facility Manual for the C2 Trusted DG/UX System.





































Licensed material--property of copyright holder(s)                         3