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

FreeBSD Manual Pages

  
 
  

home | help
pstat(2)		      System Calls Manual		      pstat(2)

NAME
       pstat(),	 pstat_getcommandline(),  pstat_getcrashdev(), pstat_getcrash-
       info(),	  pstat_getdisk(),    pstat_getdynamic(),     pstat_getfile(),
       pstat_getfile2(),	pstat_getfiledetails(),	       pstat_getipc(),
       pstat_getlv(),  pstat_getlwp(),	pstat_getmpathname(),  pstat_getmsg(),
       pstat_getnode(),	 pstat_getpathname(), pstat_getpmq(), pstat_getproc(),
       pstat_getprocessor(),	    pstat_getprocvm(),	      pstat_getpsem(),
       pstat_getpset(),	  pstat_getsem(),  pstat_getshm(),  pstat_getsocket(),
       pstat_getstable(),	 pstat_getstatic(),	    pstat_getstream(),
       pstat_getswap(),	pstat_getvminfo(), - get system	information

SYNOPSIS
   Remarks
       The underlying function is provided for backward	compatibility.	Use of
       the wrapper functions is	recommended (for example, to avoid  the	 poly-
       morphic typing of the parameter.

DESCRIPTION
       The  functions  return  information about various system	contexts.  The
       contents	of the various associated data structures, structs and are de-
       clared  in the header files and The headers contain descriptions	of the
       fields of each of the context data structures.

   Summary of Available	Contexts
       The routines support the	following contexts of  information.   Detailed
       descriptions of each routine follow.

       -------------+--------------+---------------------+----------------+------
		    |		   |			 |		  |Short
       Context	    |Struct	   |Routine		 |Instances	  |Cut
       -------------+--------------+---------------------+----------------+------
       Static	    |pst_static	   |pstat_getstatic()	 |1		  |
       Dynamic	    |pst_dynamic   |pstat_getdynamic()	 |1		  |
       VM	    |pst_vminfo	   |pstat_getvminfo()	 |1		  |
       IPC	    |pst_ipcinfo   |pstat_getipc()	 |1		  |
       Stable Store |pst_stable	   |pstat_getstable()	 |1		  |
       Crash Dumps  |pst_crashinfo |pstat_getcrashinfo() |1		  |
       -------------+--------------+---------------------+----------------+------
       Processor    |pst_processor |pstat_getprocessor() |1 per	processor |
       Disk	    |pst_diskinfo  |pstat_getdisk()	 |1 per	disk	  |
       Swap	    |pst_swapinfo  |pstat_getswap()	 |1 per	swap area |
       Dump Areas   |pst_crashdev  |pstat_getcrashdev()	 |1 per	dump area |
       Node	    |pst_node	   |pstat_getnode()	 |1 per	node	  |
       -------------+--------------+---------------------+----------------+------

       ------------+--------------+---------------------+---------------------+------
		   |		  |			|		      |Short
       Context	   |Struct	  |Routine		|Instances	      |Cut
       ------------+--------------+---------------------+---------------------+------
       Commandline |char *	  |pstat_		|1 per process	      |yes
		   |		  |getcommandline()	|		      |
       Process	   |pst_status	  |pstat_getproc()	|1 per process	      |yes
       LW Process  |lwp_status	  |pstat_getlwp()	|1 per lwp/thread     |yes
       Process VM  |pst_vm_status |pstat_getprocvm()	|1 per process region |yes
       LVM Vol	   |pst_lvinfo	  |pstat_getlv()	|1 per lvol	      |yes
       Sema Set	   |pst_seminfo	  |pstat_getsem()	|1 per sem set	      |yes
       Msg Queue   |pst_msginfo	  |pstat_getmsg()	|1 per msg queue      |yes
       Shared Mem  |pst_shminfo	  |pstat_getshm()	|1 per shm seg	      |yes
       Proc Set	   |pst_pset	  |pstat_getpset()	|1 per proc set	      |yes
       P-Sema Set  |pst_pseminfo  |pstat_getpsem()	|1 per sema	      |no

       P-Msg Queue |pst_pmqinfo	  |pstat_getpmq()	|1 per msg queue      |no
       ------------+--------------+---------------------+---------------------+------
       Open File   |pst_fileinfo  |pstat_getfile()	|1 per file	      |yes
       Open File   |pst_fileinfo2 |pstat_getfile2()	|1 per file	      |yes
       ------------+--------------+---------------------+---------------------+------
       Open File   |pst_	  |pstat_		|1 per file/call      |
		   |filedetails	  |getfiledetails()	|		      |
       Open Socket |pst_socket	  |pstat_getsocket()	|1 per socket/call    |
       Open Stream |pst_stream	  |pstat_getstream()	|1 per stream/call    |
       Open File   |char *	  |pstat_getpathname()	|1 per file/call      |
       ------------+--------------+---------------------+---------------------+------
       DNLC	   |pst_mpathnode |pstat_getmpathname()	|1 per DNLC entry     |
       ------------+--------------+---------------------+---------------------+------

   Wrapper Function Descriptions
	      Returns the commandline of the process specified in the
			parameter.   Up	to a maximum of	- 1 bytes are returned
			in the buffer if the is	less than or equal to the size
			of  the	 process  commandline.	If the is greater than
			the size of process commandline,  only	the  available
			number of bytes	are returned.  Up to a maximum of 1020
			characters of the process commandline is stored.   The
			parameter has to be one.

	      Returns information specific to a	particular crash dump device.
			There  is  one instance	of this	context	for each crash
			dump device configured on the system.	For  each  in-
			stance	requested,  data, up to	a maximum of bytes, is
			returned in the	pointed	to by The parameter  specifies
			the  number  of	that are available at to be filled in.
			The parameter specifies	the starting index within  the
			context	of crash dump devices.

	      Returns information about	the system's crash dump	configuration.
			Data,  up  to  a maximum of bytes, are returned	in the
			pointed	to by The parameter must be 1.	The  parameter
			must be	0.

	      Returns information specific to a	particular disk.  There	is one
	      instance
			of this	context	for each disk configured into the sys-
			tem.  For each instance	requested, data, up to a maxi-
			mum of bytes, is returned in the pointed to by The pa-
			rameter	 specifies the number of that are available at
			to be filled in.  The parameter	specifies the starting
			index within the context of disks.

	      Returns  dynamic	information  about  the	 system.  There	is one
	      global instance of
			this context.  Data, up	to a maximum of	bytes, is  re-
			turned	in  the	pointed	to by The parameter must be 1.
			The parameter must be 0.

	      This call	is now obsolete	and is provided	for backward  compati-
	      bility only.
			Use  of	call is	recommended.  Returns information spe-
			cific to  a  particular	 open  file  for  a  specified
			process.   For the specified process, there is one in-
			stance of this context for each	open file  descriptor.
			For  each instance requested, data, up to a maximum of
			bytes, is returned in the pointed to by	The  parameter
			specifies  the	number	of that	are available at to be
			filled in.  The	parameter specifies the	starting index
			within	the  context  of  open files for the specified
			process:  it is	a 32-bit quantity constructed  of  the
			field  of the 'owning' process,	obtained via described
			above, as the most significant 16 bits,	and the	 index
			of open	files within the process as the	least signifi-
			cant 16	bits.  Example:

			As a shortcut, information for a  single  file	within
			the  specified	process	 may be	obtained by setting to
			zero and setting the least significant 16 bits to  the
			file  descriptor  number (the most significant 16 bits
			are still set to the field from	the structure for  the
			process).

			The structure contains both a and element. The element
			can correctly store a 32-bit value, whereas  the  ele-
			ment  can store	a 64-bit value.	 will fill in both and
			if the value can be correctly stored in	both elements.
			If  the	 offset	is too large to	be correctly stored in
			then will contain a -1.	No error will be set  in  this
			case.

	      Returns  information  specific  to  a particular open file for a
	      specified
			process.  For the specified process, there is one  in-
			stance	of this	context	for each open file descriptor.
			For each instance requested, data, up to a maximum  of
			bytes,	is returned in the pointed to by The parameter
			specifies the number of	that are available  at	to  be
			filled in.  The	parameter specifies the	starting index
			within the context of open  files  for	the  specified
			process:   It is the file descriptor number with which
			to begin.  The parameter specifies the process ID.

			As a shortcut, information for a  single  file	within
			the  specified	process	 may be	obtained by setting to
			zero and setting the to	the file descriptor number.

			The structure contains both a and element. The element
			can  correctly	store a	32-bit value, whereas the ele-
			ment can store a 64-bit	value.	will fill in both  and
			if the value can be correctly stored in	both elements.
			If the offset is too large to be correctly  stored  in
			then  will  contain a -1. No error will	be set in this
			case.

	      Returns detailed information specific to a particular open file.
	      For a
			specified  opened  file, there is only one instance of
			this context. For each call, data, up to a maximum  of
			bytes,	is returned in the pointed to by The parameter
			uniquely identifies the	file. This  is	obtained  from
			calls to or The	structure contains information equiva-
			lent to	the stat(2) call. Use of this function is lim-
			ited  to  UID==0 or effective UID match. Effective UID
			match occurs when the effective	or  real  UID  of  the
			calling	 thread	 matches  the effective	or real	UID of
			the target process and the target process has NOT done
			a set[u/g]id.

			The  structure members will have meaningful values for
			regular	files, character or block special  files,  and
			pipes.	 The value of the member will be set to	number
			of links to the	file.  The member will have meaningful
			value  for character or	block special files, while the
			is valid for  regular  files.	The  members  and  are
			unique	ids  representing  the opened file.  These ids
			together are used to match the corresponding  ids  re-
			turned	from  the  This	call does not work for sockets
			other than AF_UNIX family type.

	      Returns information about	System V IPC subsystem.	 There is  one
	      global
			instance  of this context.  This data may change while
			the system is running due to administrative changes in
			the associated kernel tunables.	 Data, up to a maximum
			of bytes, is returned in the pointed to	by The parame-
			ter must be 1.	The parameter must be 0.

	      Returns  information  specific  to  a particular logical volume.
	      There is one
			instance of this context for each logical volume  con-
			figured	into the system.  For each instance requested,
			data, up to a maximum of bytes,	 is  returned  in  the
			pointed	 to  by	 The parameter specifies the number of
			that are available at to be filled in.	The  parameter
			specifies  the	starting  index	 within	the context of
			logical	volumes.  As a	shortcut,  information	for  a
			single	logical	 volume	 may be	obtained by setting to
			zero and setting to the	dev_t of that logical volume.

	      Returns information specific  to	a  particular  thread  or  LWP
	      (Lightweight Process)
			in  a  process.	 There is one instance of this context
			for each LWP in	a process on the system. For each  in-
			stance	requested,  data, up to	a maximum of bytes, is
			returned in the	pointed	to by The parameter  specifies
			the  number  of	that are available at to be filled in.
			The parameter specifies	the starting index within  the
			context	of LWPs	in a process.

			If is set to -1	and is greater than 0, entries of sys-
			tem LWP	information are	returned to  the  caller  pro-
			gram.

			If  is	greater	than or	equal to 0 and is greater than
			0, entries of LWP info within the process specified by
			are returned.

			As  a  shortcut, information about a single LWP	can be
			obtained by setting to zero and	 setting  to  the  TID
			(Thread	ID) of that LWP	within its process.

	      Returns the entries from the system cache	of recent names	looked
	      up (DNLC)
			for a specified	file system, in	The parameter uniquely
			identifies  the	 file system. This should be the field
			of a structure obtained	from calls to or The parameter
			specifies  the starting	entry within the chain of DNLC
			entries	to be returned for the	specified  filesystem.
			The  parameter specifies the number of DNLC entries to
			be returned.  Typically, the parameter will be	speci-
			fied  as zero and the parameter	will be	high enough to
			obtain all the entries of the specified	 file  system.
			For  each call,	data, up to a maximum of bytes,	is re-
			turned in the pointed to by The	structure contains the
			following members:

			is  the	 current  index	 of an entry into the chain of
			DNLC entries for the filesystem.  can be passed	on  to
			another	 call  as  the parameter to obtain the entries
			starting after the last	is the file the	current	 entry
			describes and is the parent of this file.  is the NULL
			terminated pathname component for the current entry.

			Reverse	pathname lookup	can be performed by  searching
			the  entries  for  one	that has a member equal	to the
			member of the current entry. This is done until	an en-
			try with a NULL	entry is located, which	indicates that
			the entry for the root of the  file  system  has  been
			found.	The  pathname from the root of the file	system
			is formed by concatenating the names given by the mem-
			ber  of	 each of the entries found during the process.
			If desired, the	full pathname can then	be  formed  by
			concatenating  the  pathname to	the mount point	of the
			file system.

			Use of this function is	limited	to UID==0.

			On success, the	function returns the  number  of  DNLC
			entries	 copied.   In case of failure, the value of -1
			is returned and	is set indicating  the	cause  of  the
			failure.

	      Returns information specific to a	particular
			System V message queue.	 There is one instance of this
			context	for each System	V message queue	on the system.
			For  each instance requested, data, up to a maximum of
			bytes, is returned in the pointed to by	The  parameter
			specifies  the	number	of that	are available at to be
			filled in.  The	parameter specifies the	starting index
			within	the  context of	System V message queues.  As a
			shortcut, information for a single message  queue  may
			be  obtained  by  setting to zero and setting index to
			the msqid of that message queue.

	      Returns information specific about a SCA system node.  There  is
	      one instance
			of  this  context for each SCA node on the system, for
			each instance requested, up to a maximum of bytes,  is
			returned  in the pointed to by The parameter specifies
			the number of that are available at to be  filled  in.
			The  parameter	specifies the starting logical node id
			that is	requested.

	      Returns the full pathname	of an opened file in
			if it is available in the system cache of recent names
			looked	up  (DNLC).  The parameter uniquely identifies
			the opened file. This is obtained from calls to	or The
			value  of  should  be  at  least  one greater than the
			length of the pathname to be returned.	 The  variable
			from pathconf(2) can be	used for this purpose.	Use of
			this function is limited to UID==0  or	effective  UID
			match.	Please	refer call for more information	on Ef-
			fective	UID match.

			On success, the	function returns  the  length  of  the
			pathname  copied starting at the location specified by
			If the pathname	is not available in the	system	cache,
			0  is returned and is not set.	On other failures, the
			value of -1 is returned	 and  is  set  indicating  the
			cause  of  the	failure.  This	call does not work for
			sockets.

	      Returns information  specific  to	 a  particular	POSIX  message
	      queue.  There is one
			instance  of this context for each POSIX message queue
			on the system.	For each instance requested, data,  up
			to  a  maximum of bytes, is returned in	the pointed to
			by The parameter specifies  the	 number	 of  that  are
			available at to	be filled in.  The parameter specifies
			the starting index within the context of POSIX message
			queues.

	      Returns  information specific to a particular process.  There is
	      one
			instance of this context for each  active  process  on
			the  system.  For each instance	requested, data, up to
			a maximum of bytes, is returned	in the pointed	to  by
			The  parameter specifies the number of that are	avail-
			able at	to be filled in.  The parameter	specifies  the
			starting  index	within the context of processes.  As a
			shortcut, information for a single process may be  ob-
			tained	by  setting  to	zero and setting to the	PID of
			that process.

	      Returns information specific to a	particular processor (the only
	      processor
			on  a  uniprocessor system).  There is one instance of
			this context for each processor	on  the	 system.   For
			each  instance	requested,  data,  up  to a maximum of
			bytes, is returned in the pointed to by	The  parameter
			specifies  the	number	of that	are available at to be
			filled in.  The	parameter specifies the	starting index
			within the context of processors.

	      Returns  information  specific  to a particular process' address
	      space.  There
			is one instance	of this	context	for each  process  re-
			gion  contained	 in  the  process' address space.  For
			each instance requested, data,	up  to	a  maximum  of
			bytes,	is  returned in	the pointed to by Only at most
			one instance (process region)  is  returned  for  each
			call to	The parameter identifies the process for which
			address	space information is to	be returned. An	param-
			eter  of zero indicates	that address space information
			for the	currently  executing  process  should  be  re-
			turned.	  The  parameter  specifies the	starting index
			(beginning with	0) within the context of  process  re-
			gions for the indicated	process.  For example, an of 3
			indicates the 4th process region within	the  indicated
			process'  address  space.   As a shortcut, information
			for a specific process (other than the currently  exe-
			cuting	one)  may be obtained by setting to the	PID of
			that process. More information on VM regions mapped to
			files can be obtained with the call.

	      Returns  information  specific to	a particular POSIX named sema-
	      phore.  There is
			one instance of	this context for each POSIX named sem-
			aphore	on  the	 system.  For each instance requested,
			data, up to a maximum of bytes,	 is  returned  in  the
			pointed	 to  by	 The parameter specifies the number of
			that are available at to be filled in.	The  parameter
			specifies  the	starting  index	 within	the context of
			POSIX named semaphore sets.

	      Returns information specific  to	a  particular  processor  set.
	      There is one
			instance of this context for each processor set	on the
			system.	 For each instance requested, data,  up	 to  a
			maximum	 of  bytes, are	returned in the	pointed	by The
			parameter specifies the	number of that	are  available
			at  to	be  filled  in.	  The  parameter specifies the
			starting index within the context of  processor	 sets.
			As  a shortcut,	information for	a single processor set
			may be obtained	by setting to zero and setting to  the
			pset id	of that	processor set.

	      Returns information specific to a	particular
			System V semaphore set.	 There is one instance of this
			context	for each System	V semaphore set	on the system.
			For  each instance requested, data, up to a maximum of
			bytes, is returned in the pointed to by	The  parameter
			specifies  the	number	of that	are available at to be
			filled in.  The	parameter specifies the	starting index
			within	the  context of	System V semaphore sets.  As a
			shortcut, information for a single semaphore  set  may
			be  obtained  by  setting  to  zero and	setting	to the
			semid of that semaphore	set.

	      Returns information specific to a	particular
			System V shared	memory segment.	 There is one instance
			of  this  context for each System V shared memory seg-
			ment on	the  system.   For  each  instance  requested,
			data,  up  to  a  maximum of bytes, is returned	in the
			pointed	to by The parameter specifies  the  number  of
			that  are available at to be filled in.	 The parameter
			specifies the starting index  within  the  context  of
			System	V  shared memory segments.  As a shortcut, in-
			formation for a	single shared memory  segment  may  be
			obtained  by  setting to zero and setting to the shmid
			of that	shared memory segment.

	      Returns detailed information specific to a socket. For the spec-
	      ified socket,
			there  is one instance of this context.	For each call,
			data, up to a maximum of bytes,	 is  returned  in  the
			pointed	 to  by	 The parameter uniquely	identifies the
			socket.	This is	obtained from calls to or Use of  this
			function  is limited to	UID==0 or effective UID	match.
			Please refer call for more  information	 on  effective
			UID match.

			On  success,  the  function returns 1. On failure, the
			value of -1 is returned	 and  is  set  indicating  the
			cause  of  the	failure.  For AF_UNIX sockets that are
			opened to files, more information about	the files  can
			be obtained with the call. In case of AF_UNIX sockets,
			the fields and can be used to find the peer socket  by
			matching them with and The members and contain data of
			the form etc. depending	on the socket family.

	      Returns information contained in	the  system's  stable  storage
	      area.
			There is one global instance of	this context. Data, up
			to a maximum of	bytes, is returned in the  pointed  to
			by The parameter must be 1.  The parameter must	be 0.

	      Returns information about	the system.  This data may change
			while  the  system  is	running	 due to	administrative
			changes	in the associated kernel  tunables.  There  is
			one  global  instance  of  this	context. Data, up to a
			maximum	of bytes, is returned in the pointed to	by The
			parameter must be 1.  The parameter must be 0.

	      Returns detailed information specific to a stream. For the spec-
	      ified stream,
			there is one instance of this context for  the	stream
			head,  each  module,  and  the	driver.	For each call,
			data, up to a maximum of bytes,	 is  returned  in  the
			pointed	 to  by	 The parameter specifies the number of
			that are available at to be filled in.	The  parameter
			indicates the number of	modules	to skip	before return-
			ing information	about any modules. Head	information is
			returned for every call.  The parameter	uniquely iden-
			tifies the file. This id is obtained from calls	to or

			On success, the	function returns the number of	struc-
			tures  returned	 starting at the location specified by
			This is	at least 1 as the head information  is	always
			returned.  On failure, the value of -1 is returned and
			is set indicating the cause of the failure.

			Use of this function is	limited	to UID==0 or effective
			UID  match.  Please refer call for more	information on
			Effective UID match.

			The field can be or The	union in structure will	repre-
			sent  the  structures  or in the respective cases.  If
			the flag is set	in for the  field  in  represents  the
			clone driver sequence number for the stream.

	      Returns  information  specific to	a particular swap area.	 There
	      is one
			instance of this context for each swap area (block  or
			filesystem)  configured	into the system.  For each in-
			stance requested, data,	up to a	maximum	of  bytes,  is
			returned  in the pointed to by The parameter specifies
			the number of that are available at to be  filled  in.
			The  parameter specifies the starting index within the
			context	of swap	areas.

	      Returns information about	the virtual memory subsystem. There is
	      one
			global	instance of this context.  Data, up to a maxi-
			mum of bytes, is returned in the pointed to by The pa-
			rameter	must be	1.  The	parameter must be 0.

   Notes
       A  wide (64 bit)	version	of the interfaces are available	for narrow (32
       bit) applications to use.  A narrow application could use the  flag  at
       compile time to switch to the wide interfaces. Using this compiler flag
       in a narrow application is equivalent to	using the  default  interfaces
       on a wide system.

       Refer  to  the header file to see how the various structures would look
       like when the -D_PSTAT64	flag is	used.

       The and interfaces are available	only in	the wide mode and for applica-
       tions written in	standard C and extended	ANSI.

RETURN VALUE
       Upon successful completion, and the various wrapper routines (for exam-
       ple, return the number of instances filled in at	the  address  however,
       returns the number of characters	of the process commandline returned in
       the parameter.  Otherwise, a value of -1	is returned and	is set to  in-
       dicate the error.

ERRORS
       The functions fail if any of the	following conditions are encountered:

	      [EFAULT]	     points to an invalid address.

	      [ESRCH]	     Process in	question is not	found or exiting.  For
			     the and calls, was	0, specifying the  single-item
			     short-cut,	and no item matched the	selection cri-
			     teria in (for example, PID	for

	      [ENOENT]	     For calls ENOENT is returned if the file  is  not
			     found,  or	 it is closed. For call, ENOENT	is re-
			     turned if the specified file system is not	 found
			     or	if the file system does	not have DNLC entries.

	      [EINVAL]	     For the or	calls, was not zero, and was less than
			     zero.

	      [EINVAL]	     is	less than or equal to zero or is  larger  than
			     the  size	of  the	associated data	structure (for
			     example, for the call).

	      [EINVAL]	     is	not 1 or is not	zero for the or	calls.

	      [EINVAL]	     is	not greater than or  equal  to	1  or  is  not
			     greater than or equal to zero for the or calls.

	      [EINVAL]	     is	not a valid logical node id for	call.

	      [EINVAL]	     is	less than or equal to zero for call.

	      [EINVAL]	     If	is called for a	socket other than AF_UNIX fam-
			     ily or is called for a socket.

	      [EINVAL]	     If	is called for a	file  which  is	 not  of  type
			     socket.

	      [EINVAL]	     If	 is called with	less than zero or not equal to
			     one .

	      [EACCES]	     If	uid!=0 or effective  id	 does  not  match  for
			     calls and

	      [EOVERFLOW]    Offset  element  is  too  large to	store into the
			     structure pointed to by the argument.

	      [EOVERFLOW]    For the call, a value to be stored	would overflow
			     one  of the members of the	structure.  The	member
			     indicates the field that overflowed.

	      [EOVERFLOW]    For the call, the parameter is  not  one  greater
			     than the length of	the pathname to	be returned.

	      [ENOSTR]	     is	 called	 for  a	file which is neither a	stream
			     nor a stream based	pipe/socket.

	      [EINTR]	     For call, the operation was terminated due	to the
			     receipt of	a signal, and no data was transferred.

	      [ENOBUFS]	     For call, the operation was terminated due	to un-
			     availability of buffer space.

	      [ENOSYS]	     The requested pstat function is  not  implemented
			     or	not configured in the system.

BACKWARD COMPATIBILITY
       The  specific calling convention	of passing the expected	data structure
       size is used in order to	allow for future expansion of  the  interface,
       while preserving	backwards source and object compatibility for programs
       written using the pstat interfaces.  Three rules	are followed to	 allow
       existing	applications to	continue to execute from release to release of
       the operating system.

	      o	 New data for a	context	are added to the end of	that context's
		 data structure.

	      o	 Old,  obsolete	 data members are deleted from the data	struc-
		 ture.

	      o	 The operating system honors the parameter  of	the  call  and
		 only returns the first	bytes of the context data, even	if the
		 actual	data structure has since been enlarged.

       In this way, an application which passes	its compile-time size  of  the
       context's  data structure (for example, for the per-process context) as
       the parameter will continue to execute on future	operating  system  re-
       leases  without recompilation, even those that have larger context data
       structures.  If the program is recompiled, it will also continue	to ex-
       ecute  on that and future releases.  Note that the reverse is not true:
       a program using the interfaces compiled on,  say,  HP-UX	 release  10.0
       will not	work on	HP-UX release 9.0.

       The code	examples, below, demonstrate the calling conventions described
       above.

EXAMPLES
WARNINGS
       Some parts of the program status	may not	get updated when a process be-
       comes  a	 zombie.  An example is	that the cpu percentage	is not updated
       because the process is not expected to be scheduled to run after	enter-
       ing the zombie state.

AUTHOR
       The routines were developed by HP.

FILES
       Contains	detailed descriptions of context data structures and fields.

SEE ALSO
       ps(1),  top(1),	vmstat(1), iostat(1), fuser(1M), vgdisplay(1M),	crash-
       conf(1M), stat(2), sysconf(2), semctl(2), msgctl(2), shmctl(2),	crash-
       conf(2),	sem_open(2), mq_open(2), fileno(3S), thread_safety(5).

								      pstat(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | BACKWARD COMPATIBILITY | EXAMPLES | WARNINGS | AUTHOR | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pstat&sektion=2&manpath=HP-UX+11.22>

home | help