Chapter Contents |
Previous |
Next |
chaudit |
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
AUDTREADSUCC
AUDTWRITEFAIL
AUDTWRITESUCC
AUDTEXECFAIL
AUDTEXECSUCC
The flags for the
securityType
argument are also defined in
<sys/stat.h>
and can be
either of the following:
AUDT_USER
AUDT_AUDITOR
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.
#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 |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.