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

FreeBSD Manual Pages

  
 
  

home | help
sg_init(3)							    sg_init(3)

NAME
       sg_init,	sg_snapshot, sg_shutdown, sg_drop_privileges - initialise lib-
       statgrab

SYNOPSIS
       #include	<statgrab.h>

       sg_error	sg_init	(int ignore_init_errors);

       sg_error	sg_snapshot (void);

       sg_error	sg_shutdown (void);

       sg_error	sg_drop_privileges (void);

DESCRIPTION
       sg_init() either	initialises the	statgrab library and sets the initial-
       isation counter to 1, if	not already done, or increases the initialisa-
       tion counter.  If called	for the	first time (in fact:  if  called  when
       the  initialisation counter is 0), the constructor (initialisation rou-
       tine) of	each registered	component is invoked,  some  global  variables
       are  initialised, requested mutual exclusion semaphores are initialised
       and so on.  sg_init() is	protected by the mutex named "statgrab".

       sg_snapshot() is	Win32 only and will probably disappear.

       sg_shutdown() decrements	the initialisation  counter.  If  the  counter
       reaches zero, components' destructors are called, mutual	exclusion sem-
       aphores (exept "statgrab") are destroyed	etc.   sg_shutdown()  is  pro-
       tected by the mutex named "statgrab".

       sg_drop_privileges() drops elevated privileges.

RETURN VALUES
       All  functions  return a	statgrab error code. Either SG_ERROR_NONE when
       everything was ok or the	appropriate error code from an constructor/de-
       structor.

SEE ALSO
       statgrab(3)

WEBSITE
       <http://www.i-scream.org/libstatgrab/>

i-scream			  2013-06-07			    sg_init(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | WEBSITE

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

home | help