privileges.h File Reference

#include <wireshark.h>

Go to the source code of this file.

Functions
WS_DLL_PUBLIC void	init_process_policies (void)
WS_DLL_PUBLIC bool	started_with_special_privs (void)
WS_DLL_PUBLIC bool	running_with_special_privs (void)
WS_DLL_PUBLIC void	relinquish_special_privs_perm (void)
WS_DLL_PUBLIC char *	get_cur_username (void)
WS_DLL_PUBLIC char *	get_cur_groupname (void)

Detailed Description

Declarations of routines for handling privileges.

Wireshark - Network traffic analyzer By Gerald Combs geral.nosp@m.d@wi.nosp@m.resha.nosp@m.rk.o.nosp@m.rg Copyright 2006 Gerald Combs

SPDX-License-Identifier: GPL-2.0-or-later

Function Documentation

get_cur_groupname()

WS_DLL_PUBLIC char * get_cur_groupname

(

void

)

Get the current group. String must be g_free()d after use.

Returns

A freshly g_alloc()ed string containing the group, or "UNKNOWN" on failure.

get_cur_username()

WS_DLL_PUBLIC char * get_cur_username

(

void

)

Get the current username. String must be g_free()d after use.

Returns

A freshly g_alloc()ed string containing the username, or "UNKNOWN" on failure.

init_process_policies()

WS_DLL_PUBLIC void init_process_policies

(

void

)

Called when the program starts, to enable security features and save whatever credential information we'll need later.

relinquish_special_privs_perm()

WS_DLL_PUBLIC void relinquish_special_privs_perm

(

void

)

Permanently relinquish special privileges. get_credential_info() MUST be called before calling this.

running_with_special_privs()

WS_DLL_PUBLIC bool running_with_special_privs

(

void

)

Is this program running with special privileges? get_credential_info() MUST be called before calling this.

Returns

true if the program is running with special privileges, false otherwise.

started_with_special_privs()

WS_DLL_PUBLIC bool started_with_special_privs

(

void

)

Was this program started with special privileges? get_credential_info() MUST be called before calling this.

Returns

true if the program was started with special privileges, false otherwise.