[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1


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


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:

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:

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 "How to Set Up Auditing" in AIX 5L Version 5.1 System Management Guide: Operating System and Devices for details about selecting and grouping audit events, and configuring audit event data collection.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Files


/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.

Related Information

The chssys (chssys Subroutine) subroutine, defssys (defssys Subroutine) subroutine, delssys (delssys Subroutine) subroutine.

The auditpr command, chssys command, mkssys command, rmssys command.

Auditing Overview (audit Subroutine) and System Resource Controller Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

Defining Your Subsystem to the SRC, System Resource Controller (SRC) Overview for Programmers in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

List of SRC Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]