Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

shmids(2) [opensolaris man page]

shmids(2)							   System Calls 							 shmids(2)

NAME
shmids - discover all shared memory identifiers SYNOPSIS
#include <sys/shm.h> int shmids(int *buf, uint_t nids, uint_t *pnids); DESCRIPTION
The shmids() function copies all active shared memory identifiers from the system into the user-defined buffer specified by buf, provided that the number of such identifiers is not greater than the number of integers the buffer can contain, as specified by nids. If the size of the buffer is insufficient to contain all of the active shared memory identifiers in the system, none are copied. Whether or not the size of the buffer is sufficient to contain all of them, the number of active shared memory identifiers in the system is copied into the unsigned integer pointed to by pnids. If nids is 0 or less than the number of active shared memory identifiers in the system, buf is ignored. RETURN VALUES
Upon successful completion, shmids() returns 0. Otherwise, -1 is returned and errno is set to indicate the error. ERRORS
The shmids() function will fail if: EFAULT The buf or pnids argument points to an illegal address. USAGE
The shmids() function returns a snapshot of all the active shared memory identifiers in the system. More may be added and some may be removed before they can be used by the caller. EXAMPLES
Example 1 shmids() example This is sample C code indicating how to use the shmids() function. void examine_shmids() { int *ids = NULL; uint_t nids = 0; uint_t n; int i; for (;;) { if (shmids(ids, nids, &n) != 0) { perror("shmids"); exit(1); } if (n <= nids) /* we got them all */ break; /* we need a bigger buffer */ ids = realloc(ids, (nids = n) * sizeof (int)); } for (i = 0; i < n; i++) process_shmid(ids[i]); free(ids); } ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |Async-Signal-Safe | +-----------------------------+-----------------------------+ SEE ALSO
ipcrm(1), ipcs(1), Intro(2), shmctl(2), shmget(2), shmop(2), attributes(5) SunOS 5.11 8 Mar 2000 shmids(2)

Check Out this Related Man Page

ipcrm(1)							   User Commands							  ipcrm(1)

NAME
ipcrm - remove a message queue, semaphore set, or shared memory ID SYNOPSIS
ipcrm [-z zone] [-m shmid] [-q msqid] [-s semid] [-M shmkey] [-Q msgkey] [-S semkey] DESCRIPTION
ipcrm removes one or more messages, semaphores, or shared memory identifiers. OPTIONS
The following option is supported: -z zone Keys specified by other options refer to facilities in the specified zone (see zones(5)). The default is the zone in which the command is executing. This option is only useful when the command is executed in the global zone. The identifiers are specified by the following options: -m shmid Removes the shared memory identifier shmid from the system. The shared memory segment and data structure associated with it are destroyed after the last detach. -q msqid Removes the message queue identifier msqid from the system and destroys the message queue and data structure associated with it. -s semid Removes the semaphore identifier semid from the system and destroys the set of semaphores and data structure associated with it. -M shmkey Removes the shared memory identifier, created with key shmkey, from the system. The shared memory segment and data struc- ture associated with it are destroyed after the last detach. -Q msgkey Removes the message queue identifier, created with key msgkey, from the system and destroys the message queue and data structure associated with it. -S semkey Removes the semaphore identifier, created with key semkey, from the system and destroys the set of semaphores and data structure associated with it. The details of the removes are described in msgctl(2), shmctl(2), and semctl(2). Use the ipcs command to find the identifiers and keys. ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables that affect the execution of ipcrm: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWipc | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ SEE ALSO
ipcs(1), msgctl(2), msgget(2), msgrcv(2), msgsnd(2), semctl(2), semget(2), semop(2), shmctl(2), shmget(2), shmop(2), attributes(5), envi- ron(5), standards(5), zones(5) SunOS 5.10 9 Jan 2004 ipcrm(1)
Man Page