Chapter Contents

Previous

Next
chaudit

chaudit



Change File Audit Flags (Using Pathname)

Portability: SAS/C extension


SYNOPSIS
DESCRIPTION
PORTABILITY
RETURN VALUE
EXAMPLE
RELATED FUNCTIONS


SYNOPSIS

#include <sys/stat.h>

int chaudit(const char *pathname, int auditFlags, int securityType);


DESCRIPTION

chaudit changes the audit flags for the file specified by the pathname argument. The audit flags control the type of file requests that the USS OS/390 security product audits. The chaudit function can change either user audit flags or security auditor audit flags, depending on the setting of the securityType argument.

The auditFlags argument is formed by ORing any of the following flags, which are defined in <sys/stat.h> :

AUDTREADFAIL
audit failing read requests.

AUDTREADSUCC
audit successful read requests.

AUDTWRITEFAIL
audit failing write requests.

AUDTWRITESUCC
audit successful write requests.

AUDTEXECFAIL
audit failing search or execute requests.

AUDTEXECSUCC
audit successful search or execute requests.

The flags for the securityType argument are also defined in <sys/stat.h> and can be either of the following:

AUDT_USER
specifies that the changes should be applied to the user audit flags. In order to change the user audit flags for a file, the user must be either the file owner or have the appropriate authority to make the changes.

AUDT_AUDITOR
specifies that the changes should be applied to the security auditor audit flags. This securityType argument can only be specified by a user with security auditor authority.


PORTABILITY

The chaudit function is useful in USS applications; however, it is not defined by the POSIX.1 standard and should not be used in portable applications.


RETURN VALUE

chaudit returns 0 if successful and a -1 if unsuccessful.


EXAMPLE

The following example illustrates the use of chaudit to change a file's user audit flags.

Note:    You must specify the posix option when compiling this example.  [cautionend]

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

main()
{
   int fd;
   char words[] = "Test File";

      /* Create a test file.              */
   if ((fd = creat("test.file", S_IRUSR|S_IWUSR)) == -1)  {
      perror("creat error");
      exit(1);
   }
   else {
      write(fd, words, strlen(words));
      close(fd);
   }
      /* Change the user audit flags.     */
   if (chaudit("test.file", AUDTREADFAIL|AUDTWRITEFAIL, AUDT_USER) != 0)
      perror("chaudit error");
}


RELATED FUNCTIONS

chmod , chown , fchaudit ,


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.