[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

chssys Subroutine

Purpose

Modifies the subsystem objects associated with the SubsystemName parameter.

Library

System Resource Controller Library (libsrc.a)

Syntax

#include <sys/srcobj.h>
#include <spc.h>
int chssys(SubsystemName, SRCSubsystem)
char *SubsystemName;
struct SRCsubsys *SRCSubsystem;

Description

The chssys subroutine modifies the subsystem objects associated with the specified subsystem with the values in the SRCsubsys structure. This action modifies the objects associated with subsystem in the following object classes:

The Subserver Type and Notify object classes are updated only if the subsystem name has been changed.

The SRCsubsys structure is defined in the /usr/include/sys/srcobj.h file.

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

Parameters

SRCSubsystem Points to the SRCsubsys structure.
SubsystemName Specifies the name of the subsystem.

Return Values

Upon successful completion, the chssys subroutine returns a value of 0. Otherwise, it returns a value of -1 and the odmerrno variable is set to indicate the error, or a System Resource Controller (SRC) error code is returned.

Error Codes

The chssys subroutine is unsuccessful if one or more of the following are true:

SRC_NONAME No subsystem name is specified.
SRC_NOPATH No subsystem path is specified.
SRC_BADNSIG Invalid stop normal signal.
SRC_BADFSIG Invalid stop force signal.
SRC_NOCONTACT Contact not signal, sockets, or message queues.
SRC_SSME Subsystem name does not exist.
SRC_SUBEXIST New subsystem name is already on file.
SRC_SYNEXIST New subsystem synonym name is already on file.
SRC_NOREC The specified SRCsubsys record does not exist.
SRC_SUBSYS2BIG Subsystem name is too long.
SRC_SYN2BIG Synonym name is too long.
SRC_CMDARG2BIG Command arguments are too long.
SRC_PATH2BIG Subsystem path is too long.
SRC_STDIN2BIG stdin path is too long.
SRC_STDOUT2BIG stdout path is too long.
SRC_STDERR2BIG stderr path is too long.
SRC_GRPNAM2BIG Group name is too long.

Security

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

SET_PROC_AUDIT kernel privilege
Files Accessed:
Mode File
644 /etc/objrepos/SRCsubsys
644 /etc/objrepos/SRCsubsvr
644 /etc/objrepos/SRCnotify
Auditing Events:
Event Information
SRC_Chssys

Implementation Specifics

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

Files

/etc/objrepos/SRCsubsys SRC Subsystem Configuration object class.
/etc/objrepos/SRCsubsvr SRC Subserver Configuration object class.
/etc/objrepos/SRCnotify SRC Notify Method object class.
/dev/SRC Specifies the AF_UNIX socket file.
/dev/.SRC-unix Specifies the location for temporary socket files.

Related Information

The addssys subroutine, delssys subroutine.

The chssys command, mkssys command, rmssys command.

System Resource Controller Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.

Defining Your Subsystem to the SRC, List of SRC Subroutines, System Resource Controller (SRC) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]