delssys Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

delssys Subroutine

Purpose

Removes the subsystem objects associated with the SubsystemName parameter.

Library

System Resource Controller Library (libsrc.a)

Syntax

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

int delssys (SubsystemName)
char *SubsystemName;

Description

The delssys subroutine removes the subsystem objects associated with the specified subsystem. This removes all objects associated with that subsystem from the following object classes:

Subsystem
Subserver Type
Notify

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

Parameter

SubsystemName

Specifies the name of the subsystem.

Return Values

Upon successful completion, the delssys subroutine returns a positive value. If no record is found, a value of 0 is returned. Otherwise, -1 is returned and the odmerrno variable is set to indicate the error. See "Appendix B. ODM Error Codes" for a description of possible odmerrno values.

Security

Privilege Control:

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_Delssys	Lists in an audit log the name of the subsystem being removed.

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 Subsystem 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.
/usr/include/sys/srcobj.h	Defines object structures used by the SRC.
/usr/include/spc.h	Defines external interfaces provided by the SRC subroutines.

Related Information

The addssys subroutine, chssys subroutine.

The chssys command, mkssys command, rmssys command.

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