freebsd man page for ipcs

IPCS(1) 						    BSD General Commands Manual 						   IPCS(1)

NAME
     ipcs -- report System V interprocess communication facilities status

SYNOPSIS
     ipcs [-abcmopqstMQSTy] [-C core] [-N system] [-u user]

DESCRIPTION
     The ipcs utility provides information on System V interprocess communication (IPC) facilities on the system.

     The options are as follows:

     -a      Show the maximum amount of information possible when displaying active semaphores, message queues, and shared memory segments.  (This
	     is shorthand for specifying the -b, -c, -o, -p, and -t options.)

     -b      Show the maximum allowed sizes for active semaphores, message queues, and shared memory segments.	The ``maximum allowed size'' is
	     the maximum number of bytes in a message on a message queue, the size of a shared memory segment, or the number of semaphores in a
	     set of semaphores.

     -c      Show the creator's name and group for active semaphores, message queues, and shared memory segments.

     -m      Display information about active shared memory segments.

     -o      Show outstanding usage for active message queues, and shared memory segments.  The ``outstanding usage'' is the number of messages in
	     a message queue, or the number of processes attached to a shared memory segment.

     -p      Show the process ID information for active semaphores, message queues, and shared memory segments.  The ``process ID information'' is
	     the last process to send a message to or receive a message from a message queue, the process that created a semaphore, or the last
	     process to attach or detach a shared memory segment.

     -q      Display information about active message queues.

     -s      Display information about active semaphores.

     -t      Show access times for active semaphores, message queues, and shared memory segments.  The access times is the time of the last con-
	     trol operation on an IPC object, the last send or receive of a message, the last attach or detach of a shared memory segment, or the
	     last operation on a semaphore.

     -C core
	     Extract values associated with the name list from the specified core instead of the default /dev/kmem.  Implies -y.

     -M      Display system information about shared memory.

     -N system
	     Extract the name list from the specified system instead of the default /boot/kernel/kernel.  Implies -y.

     -Q      Display system information about messages queues.

     -S      Display system information about semaphores.

     -T      Display system information about shared memory, message queues and semaphores.

     -y      Use the kvm(3) interface instead of the sysctl(3) interface to extract the required information.  If ipcs is to operate on the run-
	     ning system, using kvm(3) will require read privileges to /dev/kmem.

     -u user
	     Display information about IPC mechanisms owned by user.  User specification can be in the form of a numeric UID or a login name.

     If none of the -M, -m, -Q, -q, -S, or -s options are specified, information about all active IPC facilities is listed.

RESTRICTIONS
     System data structures may change while ipcs is running; the output of ipcs is not guaranteed to be consistent.

FILES
     /dev/kmem		  default kernel memory
     /boot/kernel/kernel  default system name list

SEE ALSO
     ipcrm(1)

AUTHORS
     Thorsten Lockert <tholo@sigmasoft.com>

BUGS
     This manual page is woefully incomplete, because it does not at all attempt to explain the information printed by ipcs.

BSD
								  March 24, 2004							       BSD