secdef(3)

NAME

secdef: open_secdef(), close_secdef(), get_secdef_str(), get_secdef_int() — security defaults configuration file routines

SYNOPSIS

#include <prot.h>

int open_secdef (void);

int close_secdef (void);

int get_secdef_str(char *parameter, char *value);

int get_secdef_int(char *parameter, char *value);

DESCRIPTION

open_secdef() opens the security configuration file /etc/default/security. This function must be called prior to calling get_secdef_str() or get_secdef_int().

close_secdef() closes the security configuration file.

get_secdef_str() and get_secdef_int() return the value of the specified parameter defined in the security configuration file. See the security(4) manpage.

Programs using these routines must be compiled with -lsec.

APPLICATION USAGE

In a multithreaded application, these interfaces are thread-safe, but not async-cancel-safe. A cancellation point may occur when a thread is executing any of these interfaces.

RETURN VALUE

open_secdef() returns a value of 0 if the open completed successfully. Otherwise, it returns -1 and leaves errno unchanged from the fstat call. get_secdef_str() and get_secdef_int() return the following:

0: The value of the specified parameter was successfully returned.
-1: The entry was not found, or the security configuration file was not opened.
-2: The format of the entry was incorrect.

EXAMPLES

This example obtains the "path" from the SU_DEFAULT_PATH=path parameter.

char supath[MAXPATHLEN+100]; 
  
if (open_secdef() == 0) { 
        if (get_secdef_str("SU_DEFAULT_PATH", supath) == 0) 
                printf("su path is %s", supath); 
        close_secdef() 
} 

FILES

/etc/default/security: Security defaults configuration file.

secdef(3)

Technical documentation

» Table of Contents

» Index