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