Content-type: text/html
Man page of create_file_securely
create_file_securely
Section: C Library Functions (3)
Index
Return to Main Contents
NAME
create_file_securely - Create a file in the authentication database (Enhanced Security)
LIBRARY
Security library (libsecurity.a)
SYNOPSIS
#include <sys/security.h>
#include <prot.h>
int create_file_securely(
char *file,
int decibels,
char *purpose);
PARAMETERS
- *file
-
The file parameter is the pathname to create.
- decibels
-
The decibels parameter is AUTH_SILENT, AUTH_LIMITED, or AUTH_VERBOSE.
Using AUTH_SILENT blocks signals.
The AUTH_LIMITED constant allows a limited amount of dialog.
Using AUTH_VERBOSE specifies that
the routine should try to wait until the file can be created (up to
100 tries, 1 second apart).
The values for decibels are as follows:
- 0
-
AUTH_SILENT
- 1
-
AUTH_LIMITED
- 2
-
AUTH_VERBOSE
- purpose
-
The purpose parameter is passed to auditd
when a file cannot be created.
It is a tag for the audit log.
DESCRIPTION
The create_file_securely routine creates a file as specified in
the authentication database.
It is more flexible than coding the discretionary
attributes of the file, and a further assurance that the file being
created is in accordance with security concerns.
If the path to the file being created does not exist,
create_file_securely attempts to create the path.
If each directory in the path is not defined in the
authentication database, create_file_securely fails.
RETURN VALUES
The create_file_securely routine returns the following values:
- 0
-
CFS_GOOD_RETURN
- 1
-
CFS_CAN_NOT_OPEN_FILE
- 2
-
CFS_NO_FILE_CONTROL_ENTRY
- 3
-
FS_CAN_NOT_CHG_MODE
- 4
-
CFS_CAN_NOT_CHG_OWNER_GROUP
FILES
The file control database.
RELATED INFORMATION
Files: files(4)
delim off
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- PARAMETERS
-
- DESCRIPTION
-
- RETURN VALUES
-
- FILES
-
- RELATED INFORMATION
-
This document was created by
man2html,
using the manual pages.
Time: 02:41:11 GMT, October 02, 2010