| 118 |
|
<function>statgrab_init</function> must be the first |
| 119 |
|
function you call before you start to use libstatgrab; it performs all |
| 120 |
|
the one-time initialisation operations that need setuid/setgid |
| 121 |
< |
privileges (for instance, on *BSD it opens a descriptor to be able to |
| 121 |
> |
privileges. For instance, on *BSD it opens a descriptor to be able to |
| 122 |
|
read kernel structures later on, and on Solaris it reads the device |
| 123 |
< |
mappings that are only accessible by root). Once this has run, |
| 124 |
< |
the other libstatgrab functions no longer need elevated privileges. |
| 125 |
< |
It is therefore a good idea to call |
| 123 |
> |
mappings that in some cases are only accessible by root (machines with |
| 124 |
> |
a /dev/osa). Once this has run, the other libstatgrab functions no longer |
| 125 |
> |
need elevated privileges. It is therefore a good idea to call |
| 126 |
|
<function>statgrab_drop_privileges</function>, which discards |
| 127 |
|
setuid and setgid privileges, immediately after you call |
| 128 |
|
<function>statgrab_init</function>, unless your application has |
