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>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:
- Subsystem Environment
- Subserver Type
- Notify
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
| Item | Description |
|---|---|
| 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:
| Item | Description |
|---|---|
| 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| Item | Description |
|---|---|
| Files Accessed: |
| Mode | File |
|---|---|
| 644 | /etc/objrepos/SRCsubsys |
| 644 | /etc/objrepos/SRCsubsvr |
| 644 | /etc/objrepos/SRCnotify |
| Auditing Events: | |
| Event | Information |
| SRC_Chssys |
Files
| Item | Description |
|---|---|
| /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. |