cafslogger(8)                       CLIX                       cafslogger(8)



  NAME

    cafslogger - Logs error messages to a specific log file

  SYNOPSIS

    /etc/cafslogger [log_file]

  DESCRIPTION

    The cafslogger daemon is invoked by the ca_config command.  The cafslogger
    daemon is responsible for writing Cache File System (CAFS) error messages
    to a log file and to the console.  The location of the log file is
    determined by the LOG_NAME keyword value in the /etc/ca_config_file.  If
    the LOG_NAME keyword does not exist, the daemon will default to logging
    messages to /usr/ip32/cafs/cafs.log and /dev/console files.

    The user should not issue the cafslogger daemon unless the cafslogger
    daemon has been stopped by accident.  If the cafslogger daemon is not
    running, no CAFS messages will be displayed.  The ca_config command
    automatically starts the cafslogger command, which is done when cache is
    started by way of the /etc/init.d/cache file.

    If for any reason the CAFS messages cannot be written to the designated
    LOG_NAME file, a default file will be opened in the /usr/ip32/cafs
    directory as the filename cafs.log.X, where X is a number starting with 1.
    For instance, if the LOG_NAME file reaches the ulimit, any writes to this
    file will error off.  At this point, the cafslogger command creates a
    /usr/ip32/cafs/cafs.log.1 file and write the data to this file.  When the
    writes fail to /usr/ip32/cafs/cafs.log.1 a /usr/ip32/cafs/cafs.log.2 will
    be created and the writes will be written at that location.

    It is best to monitor the size of the error log file because it will
    constantly grow in size.  If disk space is limited, periodically clean out
    the log file by removing data with old time stamps.

  EXAMPLES

    To manually start the cafslogger daemon, key in the following command
    line:

    cafslogger /usr/ip32/cafs/cafs.log


  DIAGNOSTICS

    The following is a list of common error messages and their meanings:

    cafslogger: Warning: Could not open CAFS log_file_name
           An error occurred because a specified log file could not be opened.
           The default log file will be automatically selected instead of the



  2/94 - Intergraph Corporation                                              1

  cafslogger(8)                       CLIX                       cafslogger(8)



           log_file_name requested.


    cafslogger: Warning cafslogger is already running
           An error occurred while the cafslogger daemon was running, and the
           user attempted to restart cafslogger.  This error message is only
           for information purposes.


    cafslogger: Error: cafslogger ABORTED! CAFS LOGGING WILL BE ABORTED!

    CONTACT SYSTEM ADMINISTRATOR!
           An error occurred because the cafslogger daemon was terminated
           while the Cache File System (CAFS) was running.  All messages from
           CAFS will not be displayed.

  RELATED INFORMATION

    Commands:  ca_config(8), ca_deconfig(8)



































  2                                              Intergraph Corporation - 2/94