acct(2)                                                   acct(2)



NAME
     acct - enable or disable process accounting

SYNOPSIS
     int acct(path)
     char *path;

DESCRIPTION
     acct is used to enable or disable the system process
     accounting routine.  If the routine is enabled, an
     accounting record will be written on an accounting file for
     each process that terminates.  Termination can be caused by
     one of two things: an exit call or a signal (see exit(2) and
     signal(3)).  The effective user ID of the calling process
     must be superuser to use this call.

     path points to a pathname naming the accounting file.  The
     accounting file format is given in acct(4).

     The accounting routine is enabled if path is nonzero and no
     errors occur during the system call.  It is disabled if path
     is zero and no errors occur during the system call.

STATUS MESSAGES AND VALUES
     Upon successful completion, a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

     The acct command will fail if one or more of the following
     is true:

     EPERM
          A pathname contains a character with the high-order bit
          set.

     EPERM
          The effective user ID of the calling process is not
          superuser.

     ENAMETOOLONG
          A component of a pathname exceeded NAME_MAX characters,
          or an entire pathname exceeded PATH_MAX.

     ELOOP
          Too many symbolic links were encountered in translating
          a pathname.

     EBUSY
          An attempt is being made to enable accounting when it
          is already enabled.

     ENOTDIR



January 1992                                                    1

acct(2)                                                   acct(2)



          A component of the path prefix is not a directory.

     ENOENT
          One or more components of the accounting filepath name
          do not exist.

     EACCES
          A component of the path prefix denies search
          permission.

     EACCES
          The file named by path is not an ordinary file.

     EACCES
          mode permission is denied for the named accounting
          file.

     EROFS
          The named file resides on a read-only file system.

     EFAULT
          path points to an illegal address.

SEE ALSO
     exit(2), signal(3), acct(4)

     acct(1M) in A/UX System Administrator's Reference




























2                                                    January 1992