addssys Subroutine

Purpose

Adds the SRCsubsys record to the subsystem object class.

Library

System Resource Controller Library (libsrc.a)

Syntax

#include <sys/srcobj.h>
#include <spc.h>

int addssys ( SRCSubsystem )
struct SRCsubsys *SRCSubsystem;

Description

The addssys subroutine adds a record to the subsystem object class. You must call the defssys subroutine to initialize the SRCSubsystem buffer before your application program uses the SRCsubsys structure. The SRCsubsys structure is defined in the /usr/include/sys/srcobj.h file.

The executable running with this subroutine must be running with the group system.

Parameters

Item Description
SRCSubsystem A pointer to the SRCsubsys structure.

Return Values

Upon successful completion, the addssys subroutine returns a value of 0. Otherwise, it returns a value of -1 and the odmerrno variable is set to indicate the error, or an SRC error code is returned.

Error Codes

The addssys subroutine fails if one or more of the following are true:

Item Description
SRC_BADFSIG Invalid stop force signal.
SRC_BADNSIG Invalid stop normal signal.
SRC_CMDARG2BIG Command arguments too long.
SRC_GRPNAM2BIG Group name too long.
SRC_NOCONTACT Contact not signal, sockets, or message queue.
SRC_NONAME No subsystem name specified.
SRC_NOPATH No subsystem path specified.
SRC_PATH2BIG Subsystem path too long.
SRC_STDERR2BIG stderr path too long.
SRC_STDIN2BIG stdin path too long.
SRC_STDOUT2BIG stdout path too long.
SRC_SUBEXIST New subsystem name already on file.
SRC_SUBSYS2BIG Subsystem name too long.
SRC_SYNEXIST New subsystem synonym name already on file.
SRC_SYN2BIG Synonym name too long.

Security

Privilege Control: This command has the Trusted Path attribute. It has the following kernel privilege:

Item Description
SET_PROC_AUDIT  
Files Accessed:  
Mode File
644 /etc/objrepos/SRCsubsys
Auditing Events:  

If the auditing subsystem has been properly configured and is enabled, the addssys subroutine generates the following audit record (event) each time the subroutine is executed:

Event Information
SRC_addssys Lists the SRCsubsys records added.

See "Setting Up Auditing" in AIX® Version 7.1 Security for details about selecting and grouping audit events, and configuring audit event data collection.

Files

Item Description
/etc/objrepos/SRCsubsys SRC Subsystem Configuration object class.
/dev/SRC Specifies the AF_UNIX socket file.
/dev/.SRC-unix Specifies the location for temporary socket files.
/usr/include/spc.h Defines external interfaces provided by the SRC subroutines.
/usr/include/sys/srcobj.h Defines object structures used by the SRC.