Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
IPCS(1) 		     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 communica-
     tion (IPC) facilities on the system.

     The options are as follows:

     -a      Show the maximum amount of information possible when displaying ac-
	     tive 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 mem-
	     ory 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  control
	     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  de-
	     fault /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  ex-
	     tract  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 spec-
	     ification 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.

FreeBSD 15.1			 March 24, 2004 			 IPCS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ipcs&sektion=1&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help