Utility functions (_dbus_assert(), _dbus_warn(), etc.) More...

Data Structures
struct	DBusBabysitter
	Babysitter implementation details. More...

struct	DBusDirIter
	Internals of directory iterator. More...

Macros
#define	_dbus_assert(condition) _dbus_real_assert ((condition) != 0, #condition, __FILE__, __LINE__, _DBUS_FUNCTION_NAME)
	Aborts with an error message if the condition is false. More...

#define	_dbus_assert_not_reached(explanation) _dbus_real_assert_not_reached (explanation, __FILE__, __LINE__)
	Aborts with an error message if called. More...

#define	_DBUS_N_ELEMENTS(array) ((int) (sizeof ((array)) / sizeof ((array)[0])))
	Computes the number of elements in a fixed-size array using sizeof(). More...

#define	_DBUS_POINTER_TO_INT(pointer) ((intptr_t)(pointer))
	Safely casts a void* to an integer; should only be used on void* that actually contain integers, for example one created with _DBUS_INT_TO_POINTER. More...

#define	_DBUS_INT_TO_POINTER(integer) ((void*)((intptr_t)(integer)))
	Safely stuffs an integer into a pointer, to be extracted later with _DBUS_POINTER_TO_INT. More...

#define	_DBUS_ZERO(object) (memset (&(object), '\0', sizeof ((object))))
	Sets all bits in an object to zero. More...

#define	_DBUS_INT16_MIN ((dbus_int16_t) 0x8000)
	Minimum value of type "int16". More...

#define	_DBUS_INT16_MAX ((dbus_int16_t) 0x7fff)
	Maximum value of type "int16". More...

#define	_DBUS_UINT16_MAX ((dbus_uint16_t)0xffff)
	Maximum value of type "uint16". More...

#define	_DBUS_INT32_MIN ((dbus_int32_t) 0x80000000)
	Minimum value of type "int32". More...

#define	_DBUS_INT32_MAX ((dbus_int32_t) 0x7fffffff)
	Maximum value of type "int32". More...

#define	_DBUS_UINT32_MAX ((dbus_uint32_t)0xffffffff)
	Maximum value of type "uint32". More...

#define	_DBUS_INT_MIN _DBUS_INT32_MIN
	Minimum value of type "int". More...

#define	_DBUS_INT_MAX _DBUS_INT32_MAX
	Maximum value of type "int". More...

#define	_DBUS_UINT_MAX _DBUS_UINT32_MAX
	Maximum value of type "uint". More...

#define	_DBUS_LOCK_NAME(name) _DBUS_LOCK_##name
	Expands to name of a global lock variable. More...

#define	_DBUS_LOCK(name) _dbus_lock (_DBUS_LOCK_##name)
	Locks a global lock, initializing it first if necessary. More...

#define	_DBUS_UNLOCK(name) _dbus_unlock (_DBUS_LOCK_##name)
	Unlocks a global lock. More...

#define	LIVE_CHILDREN(sitter) ((sitter)->socket_to_babysitter.fd >= 0 \|\| (sitter)->error_pipe_from_child >= 0)
	Macro returns TRUE if the babysitter still has live sockets open to the babysitter child or the grandchild. More...

#define	READ_END 0
	Helps remember which end of the pipe is which. More...

#define	WRITE_END 1
	Helps remember which end of the pipe is which. More...

Typedefs
typedef void(*	DBusForeachFunction) (void element, void data)
	Used to iterate over each item in a collection, such as a DBusList. More...

Enumerations
enum	ReadStatus { READ_STATUS_OK , READ_STATUS_ERROR , READ_STATUS_EOF }
	Enumeration for status of a read() More...

enum	{ CHILD_EXITED , CHILD_FORK_FAILED , CHILD_EXEC_FAILED , CHILD_PID }

Functions
void	_dbus_warn (const char *format,...)
	Prints a warning message to stderr. More...

void	_dbus_warn_check_failed (const char *format,...)
	Prints a "critical" warning to stderr when an assertion fails; differs from _dbus_warn primarily in that it defaults to fatal. More...

char *	_dbus_strdup (const char *str)
	Duplicates a string. More...

void *	_dbus_memdup (const void *mem, size_t n_bytes)
	Duplicates a block of memory. More...

char **	_dbus_dup_string_array (const char **array)
	Duplicates a string array. More...

dbus_bool_t	_dbus_string_array_contains (const char *array, const char str)
	Checks whether a string array contains the given string. More...

size_t	_dbus_string_array_length (const char **array)
	Returns the size of a string array. More...

dbus_bool_t	_dbus_generate_uuid (DBusGUID uuid, DBusError error)
	Generates a new UUID. More...

dbus_bool_t	_dbus_uuid_encode (const DBusGUID uuid, DBusString encoded)
	Hex-encode a UUID. More...

dbus_bool_t	_dbus_write_uuid_file (const DBusString filename, const DBusGUID uuid, DBusError *error)
	Write the give UUID to a file. More...

dbus_bool_t	_dbus_read_uuid_file (const DBusString filename, DBusGUID uuid, dbus_bool_t create_if_not_found, DBusError *error)
	Reads (and optionally writes) a uuid to a file. More...

dbus_bool_t	_dbus_get_local_machine_uuid_encoded (DBusString uuid_str, DBusError error)
	Gets the hex-encoded UUID of the machine this function is executed on. More...

void	_dbus_warn_return_if_fail (const char function, const char assertion, const char *file, int line)

void	_dbus_real_assert (dbus_bool_t condition, const char condition_text, const char file, int line, const char *func)
	Internals of _dbus_assert(); it's a function rather than a macro with the inline code so that the assertion failure blocks don't show up in test suite coverage, and to shrink code size. More...

void	_dbus_real_assert_not_reached (const char explanation, const char file, int line)
	Internals of _dbus_assert_not_reached(); it's a function rather than a macro with the inline code so that the assertion failure blocks don't show up in test suite coverage, and to shrink code size. More...

DBusBabysitter *	_dbus_babysitter_ref (DBusBabysitter *sitter)
	Increment the reference count on the babysitter object. More...

void	_dbus_babysitter_unref (DBusBabysitter *sitter)
	Decrement the reference count on the babysitter object. More...

void	_dbus_babysitter_kill_child (DBusBabysitter *sitter)
	Blocks until the babysitter process gives us the PID of the spawned grandchild, then kills the spawned grandchild. More...

dbus_bool_t	_dbus_babysitter_get_child_exited (DBusBabysitter *sitter)
	Checks whether the child has exited, without blocking. More...

dbus_bool_t	_dbus_babysitter_get_child_exit_status (DBusBabysitter sitter, int status)
	Gets the exit status of the child. More...

void	_dbus_babysitter_set_child_exit_error (DBusBabysitter sitter, DBusError error)
	Sets the DBusError with an explanation of why the spawned child process exited (on a signal, or whatever). More...

dbus_bool_t	_dbus_babysitter_set_watch_functions (DBusBabysitter sitter, DBusAddWatchFunction add_function, DBusRemoveWatchFunction remove_function, DBusWatchToggledFunction toggled_function, void data, DBusFreeFunction free_data_function)
	Sets watch functions to notify us when the babysitter object needs to read/write file descriptors. More...

dbus_bool_t	_dbus_spawn_async_with_babysitter (DBusBabysitter *sitter_p, const char log_name, char const argv, char const env, DBusSpawnFlags flags, DBusSpawnChildSetupFunc child_setup, void user_data, DBusError error)
	Spawns a new process. More...

void	_dbus_babysitter_set_result_function (DBusBabysitter sitter, DBusBabysitterFinishedFunc finished, void user_data)

dbus_bool_t	_dbus_become_daemon (const DBusString pidfile, DBusPipe print_pid_pipe, DBusError *error, dbus_bool_t keep_umask)
	Does the chdir, fork, setsid, etc. More...

dbus_bool_t	_dbus_write_pid_to_file_and_pipe (const DBusString pidfile, DBusPipe print_pid_pipe, dbus_pid_t pid_to_write, DBusError *error)
	Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a pipe (if non-NULL). More...

dbus_bool_t	_dbus_verify_daemon_user (const char *user)
	Verify that after the fork we can successfully change to this user. More...

dbus_bool_t	_dbus_change_to_daemon_user (const char user, DBusError error)
	Changes the user and group the bus is running as. More...

DBusRLimit *	_dbus_rlimit_save_fd_limit (DBusError *error)

dbus_bool_t	_dbus_rlimit_raise_fd_limit (DBusError *error)

dbus_bool_t	_dbus_rlimit_restore_fd_limit (DBusRLimit saved, DBusError error)

void	_dbus_rlimit_free (DBusRLimit *lim)

void	_dbus_set_signal_handler (int sig, DBusSignalHandler handler)
	Installs a UNIX signal handler. More...

dbus_bool_t	_dbus_file_exists (const char *file)
	Checks if a file exists. More...

dbus_bool_t	_dbus_user_at_console (const char username, DBusError error)
	Checks if user is at the console. More...

dbus_bool_t	_dbus_path_is_absolute (const DBusString *filename)
	Checks whether the filename is an absolute path. More...

dbus_bool_t	_dbus_stat (const DBusString filename, DBusStat statbuf, DBusError *error)
	stat() wrapper. More...

DBusDirIter *	_dbus_directory_open (const DBusString filename, DBusError error)
	Open a directory to iterate over. More...

dbus_bool_t	_dbus_directory_get_next_file (DBusDirIter iter, DBusString filename, DBusError *error)
	Get next file in the directory. More...

void	_dbus_directory_close (DBusDirIter *iter)
	Closes a directory iteration. More...

dbus_bool_t	_dbus_group_info_fill (DBusGroupInfo info, const DBusString groupname, DBusError *error)
	Initializes the given DBusGroupInfo struct with information about the given group name. More...

dbus_bool_t	_dbus_group_info_fill_gid (DBusGroupInfo info, dbus_gid_t gid, DBusError error)
	Initializes the given DBusGroupInfo struct with information about the given group ID. More...

dbus_bool_t	_dbus_parse_unix_user_from_config (const DBusString username, dbus_uid_t uid_p)
	Parse a UNIX user from the bus config file. More...

dbus_bool_t	_dbus_parse_unix_group_from_config (const DBusString groupname, dbus_gid_t gid_p)
	Parse a UNIX group from the bus config file. More...

dbus_bool_t	_dbus_unix_groups_from_uid (dbus_uid_t uid, dbus_gid_t *group_ids, int n_group_ids, DBusError *error)
	Gets all groups corresponding to the given UNIX user ID. More...

dbus_bool_t	_dbus_unix_user_is_at_console (dbus_uid_t uid, DBusError *error)
	Checks to see if the UNIX user ID is at the console. More...

dbus_bool_t	_dbus_unix_user_is_process_owner (dbus_uid_t uid)
	Checks to see if the UNIX user ID matches the UID of the process. More...

dbus_bool_t	_dbus_windows_user_is_process_owner (const char *windows_sid)
	Checks to see if the Windows user SID matches the owner of the process. More...

dbus_bool_t	_dbus_generate_random_bytes_buffer (char buffer, int n_bytes, DBusError error)
	Fills n_bytes of the given buffer with random bytes. More...

dbus_bool_t	_dbus_generate_random_ascii (DBusString str, int n_bytes, DBusError error)
	Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII subset. More...

const char *	_dbus_error_from_errno (int error_number)
	Converts a UNIX errno, or Windows errno or WinSock error value into a DBusError name. More...

const char *	_dbus_error_from_system_errno (void)
	Converts the current system errno value into a DBusError name. More...

void	_dbus_set_errno_to_zero (void)
	Assign 0 to the global errno variable. More...

dbus_bool_t	_dbus_get_is_errno_enomem (int e)
	See if errno is ENOMEM. More...

dbus_bool_t	_dbus_get_is_errno_eintr (int e)
	See if errno is EINTR. More...

dbus_bool_t	_dbus_get_is_errno_epipe (int e)
	See if errno is EPIPE. More...

dbus_bool_t	_dbus_get_is_errno_etoomanyrefs (int e)
	See if errno is ETOOMANYREFS. More...

const char *	_dbus_strerror_from_errno (void)
	Get error message from errno. More...

void	_dbus_log (DBusSystemLogSeverity severity, const char *msg,...)
	Log a message to the system log file (e.g. More...

dbus_bool_t	_dbus_inet_sockaddr_to_string (const void sockaddr_pointer, size_t len, char string, size_t string_len, const char *family_name, dbus_uint16_t port, DBusError *error)

void	_dbus_set_error_with_inet_sockaddr (DBusError error, const void sockaddr_pointer, size_t len, const char *description, int saved_errno)

void	_dbus_combine_tcp_errors (DBusList *sources, const char summary, const char host, const char port, DBusError *dest)

dbus_bool_t	_dbus_is_console_user (dbus_uid_t uid, DBusError *error)
	Checks to see if the UID sent in is the console user. More...

dbus_bool_t	_dbus_get_user_id (const DBusString username, dbus_uid_t uid)
	Gets user ID given username. More...

dbus_bool_t	_dbus_get_group_id (const DBusString groupname, dbus_gid_t gid)
	Gets group ID given groupname. More...

dbus_bool_t	_dbus_get_user_id_and_primary_group (const DBusString username, dbus_uid_t uid_p, dbus_gid_t *gid_p)
	Gets user ID and primary group given username. More...

const DBusGroupInfo *	_dbus_user_database_lookup_group (DBusUserDatabase db, dbus_gid_t gid, const DBusString groupname, DBusError *error)
	Looks up a gid or group name in the user database. More...

dbus_bool_t	_dbus_groups_from_uid (dbus_uid_t uid, dbus_gid_t *group_ids, int n_group_ids, DBusError *error)
	Gets all groups corresponding to the given UID. More...

void	_dbus_user_info_unref (DBusUserInfo *info)
	Decrements the reference count. More...

void	_dbus_group_info_unref (DBusGroupInfo *info)
	Decrements the reference count. More...

void	_dbus_user_info_free (DBusUserInfo *info)
	Frees the members of info (but not info itself) More...

void	_dbus_group_info_free (DBusGroupInfo *info)
	Frees the members of info (but not info itself). More...

dbus_bool_t	_dbus_is_a_number (const DBusString str, unsigned long num)
	Checks if a given string is actually a number and converts it if it is. More...

const DBusUserInfo *	_dbus_user_database_lookup (DBusUserDatabase db, dbus_uid_t uid, const DBusString username, DBusError *error)
	Looks up a uid or username in the user database. More...

dbus_bool_t	_dbus_user_database_lock_system (void)
	Locks global system user database. More...

void	_dbus_user_database_unlock_system (void)
	Unlocks global system user database. More...

DBusUserDatabase *	_dbus_user_database_get_system (void)
	Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system()). More...

void	_dbus_user_database_flush_system (void)
	Flushes the system global user database;. More...

dbus_bool_t	_dbus_username_from_current_process (const DBusString **username)
	Gets username of user owning current process. More...

dbus_bool_t	_dbus_homedir_from_current_process (const DBusString **homedir)
	Gets homedir of user owning current process. More...

dbus_bool_t	_dbus_homedir_from_uid (dbus_uid_t uid, DBusString *homedir)
	Gets the home directory for the given user. More...

dbus_bool_t	_dbus_credentials_add_from_user (DBusCredentials credentials, const DBusString username, DBusCredentialsAddFlags flags, DBusError *error)
	Adds the credentials corresponding to the given username. More...

DBusUserDatabase *	_dbus_user_database_new (void)
	Creates a new user database object used to look up and cache user information. More...

void	_dbus_user_database_flush (DBusUserDatabase *db)
	Flush all information out of the user database. More...

void	_dbus_user_database_unref (DBusUserDatabase *db)
	Decrements refcount of user database. More...

dbus_bool_t	_dbus_user_database_get_uid (DBusUserDatabase db, dbus_uid_t uid, const DBusUserInfo info, DBusError error)
	Gets the user information for the given UID, returned user info should not be freed. More...

dbus_bool_t	_dbus_user_database_get_username (DBusUserDatabase db, const DBusString username, const DBusUserInfo *info, DBusError error)
	Gets the user information for the given username. More...

Variables
const char *	_dbus_no_memory_message = "Not enough memory"
	Fixed "out of memory" error message, just to avoid making up a different string every time and wasting space. More...

Detailed Description

Utility functions (_dbus_assert(), _dbus_warn(), etc.)

Macro Definition Documentation

◆ _dbus_assert

#define _dbus_assert ( condition ) _dbus_real_assert ((condition) != 0, #condition, __FILE__, __LINE__, _DBUS_FUNCTION_NAME)

Aborts with an error message if the condition is false.

Parameters

condition condition which must be true.

Definition at line 153 of file dbus-internals.h.

◆ _dbus_assert_not_reached

#define _dbus_assert_not_reached ( explanation ) _dbus_real_assert_not_reached (explanation, __FILE__, __LINE__)

Aborts with an error message if called.

The given explanation will be printed.

Parameters

explanation explanation of what happened if the code was reached.

Definition at line 164 of file dbus-internals.h.

◆ _DBUS_INT16_MAX

#define _DBUS_INT16_MAX ((dbus_int16_t) 0x7fff)

Maximum value of type "int16".

Definition at line 304 of file dbus-internals.h.

◆ _DBUS_INT16_MIN

#define _DBUS_INT16_MIN ((dbus_int16_t) 0x8000)

Minimum value of type "int16".

Definition at line 303 of file dbus-internals.h.

◆ _DBUS_INT32_MAX

#define _DBUS_INT32_MAX ((dbus_int32_t) 0x7fffffff)

Maximum value of type "int32".

Definition at line 307 of file dbus-internals.h.

◆ _DBUS_INT32_MIN

#define _DBUS_INT32_MIN ((dbus_int32_t) 0x80000000)

Minimum value of type "int32".

Definition at line 306 of file dbus-internals.h.

◆ _DBUS_INT_MAX

#define _DBUS_INT_MAX _DBUS_INT32_MAX

Maximum value of type "int".

Definition at line 311 of file dbus-internals.h.

◆ _DBUS_INT_MIN

#define _DBUS_INT_MIN _DBUS_INT32_MIN

Minimum value of type "int".

Definition at line 310 of file dbus-internals.h.

◆ _DBUS_INT_TO_POINTER

#define _DBUS_INT_TO_POINTER ( integer ) ((void*)((intptr_t)(integer)))

Safely stuffs an integer into a pointer, to be extracted later with _DBUS_POINTER_TO_INT.

Only guaranteed to preserve 32 bits.

Parameters

integer the integer to stuff into a pointer.

Definition at line 192 of file dbus-internals.h.

◆ _DBUS_LOCK

#define _DBUS_LOCK ( name ) _dbus_lock (_DBUS_LOCK_##name)

Locks a global lock, initializing it first if necessary.

Returns: FALSE if not enough memory

Definition at line 421 of file dbus-internals.h.

◆ _DBUS_LOCK_NAME

#define _DBUS_LOCK_NAME ( name ) _DBUS_LOCK_##name

Expands to name of a global lock variable.

Definition at line 420 of file dbus-internals.h.

◆ _DBUS_N_ELEMENTS

#define _DBUS_N_ELEMENTS ( array ) ((int) (sizeof ((array)) / sizeof ((array)[0])))

Computes the number of elements in a fixed-size array using sizeof().

Parameters

array the array to count elements in.

Definition at line 189 of file dbus-internals.h.

◆ _DBUS_POINTER_TO_INT

#define _DBUS_POINTER_TO_INT ( pointer ) ((intptr_t)(pointer))

Safely casts a void* to an integer; should only be used on void* that actually contain integers, for example one created with _DBUS_INT_TO_POINTER.

Only guaranteed to preserve 32 bits. (i.e. it's used to store 32-bit ints in pointers, but can't be used to store 64-bit pointers in ints.)

Parameters

pointer pointer to extract an integer from.

Definition at line 191 of file dbus-internals.h.

◆ _DBUS_UINT16_MAX

#define _DBUS_UINT16_MAX ((dbus_uint16_t)0xffff)

Maximum value of type "uint16".

Definition at line 305 of file dbus-internals.h.

◆ _DBUS_UINT32_MAX

#define _DBUS_UINT32_MAX ((dbus_uint32_t)0xffffffff)

Maximum value of type "uint32".

Definition at line 308 of file dbus-internals.h.

◆ _DBUS_UINT_MAX

#define _DBUS_UINT_MAX _DBUS_UINT32_MAX

Maximum value of type "uint".

Definition at line 312 of file dbus-internals.h.

◆ _DBUS_UNLOCK

#define _DBUS_UNLOCK ( name ) _dbus_unlock (_DBUS_LOCK_##name)

Unlocks a global lock.

Definition at line 422 of file dbus-internals.h.

◆ _DBUS_ZERO

#define _DBUS_ZERO ( object ) (memset (&(object), '\0', sizeof ((object))))

Sets all bits in an object to zero.

Parameters

object the object to be zeroed.

Definition at line 194 of file dbus-internals.h.

◆ LIVE_CHILDREN

#define LIVE_CHILDREN ( sitter ) ((sitter)->socket_to_babysitter.fd >= 0 || (sitter)->error_pipe_from_child >= 0)

Macro returns TRUE if the babysitter still has live sockets open to the babysitter child or the grandchild.

Definition at line 695 of file dbus-spawn-unix.c.

◆ READ_END

#define READ_END 0

Helps remember which end of the pipe is which.

Definition at line 893 of file dbus-spawn-unix.c.

◆ WRITE_END

#define WRITE_END 1

Helps remember which end of the pipe is which.

Definition at line 895 of file dbus-spawn-unix.c.

Typedef Documentation

◆ DBusForeachFunction

DBusForeachFunction

Used to iterate over each item in a collection, such as a DBusList.

Definition at line 331 of file dbus-internals.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Definition at line 238 of file dbus-spawn-unix.c.

◆ ReadStatus

enum ReadStatus

Enumeration for status of a read()

Enumerator
READ_STATUS_OK	Read succeeded.
READ_STATUS_ERROR	Some kind of error.
READ_STATUS_EOF	EOF returned.

Definition at line 73 of file dbus-spawn-unix.c.

Function Documentation

◆ _dbus_babysitter_get_child_exit_status()

dbus_bool_t _dbus_babysitter_get_child_exit_status	(	DBusBabysitter *	sitter,
		int *	status
	)

Gets the exit status of the child.

We do this so implementation specific detail is not cluttering up dbus, for example the system launcher code. This can only be called if the child has exited, i.e. call _dbus_babysitter_get_child_exited(). It returns FALSE if the child did not return a status code, e.g. because the child was signaled or we failed to ever launch the child in the first place.

Parameters

sitter	the babysitter
status	the returned status code

Returns: FALSE on failure

Definition at line 751 of file dbus-spawn-unix.c.

References _dbus_assert_not_reached, _dbus_babysitter_get_child_exited(), FALSE, DBusBabysitter::have_child_status, DBusBabysitter::status, and TRUE.

◆ _dbus_babysitter_get_child_exited()

dbus_bool_t _dbus_babysitter_get_child_exited ( DBusBabysitter * sitter )

Checks whether the child has exited, without blocking.

Parameters

sitter the babysitter

Definition at line 726 of file dbus-spawn-unix.c.

References LIVE_CHILDREN.

Referenced by _dbus_babysitter_get_child_exit_status(), and _dbus_babysitter_set_child_exit_error().

◆ _dbus_babysitter_kill_child()

void _dbus_babysitter_kill_child ( DBusBabysitter * sitter )

Blocks until the babysitter process gives us the PID of the spawned grandchild, then kills the spawned grandchild.

Parameters

sitter the babysitter object

Definition at line 704 of file dbus-spawn-unix.c.

References DBusBabysitter::grandchild_pid, and LIVE_CHILDREN.

◆ _dbus_babysitter_ref()

DBusBabysitter * _dbus_babysitter_ref ( DBusBabysitter * sitter )

Increment the reference count on the babysitter object.

Parameters

sitter the babysitter

Returns: the babysitter

Definition at line 312 of file dbus-spawn-unix.c.

References _dbus_assert, NULL, and DBusBabysitter::refcount.

◆ _dbus_babysitter_set_child_exit_error()

void _dbus_babysitter_set_child_exit_error	(	DBusBabysitter *	sitter,
		DBusError *	error
	)

Sets the DBusError with an explanation of why the spawned child process exited (on a signal, or whatever).

If the child process has not exited, does nothing (error will remain unset).

Parameters

sitter	the babysitter
error	an error to fill in

Definition at line 775 of file dbus-spawn-unix.c.

References _dbus_babysitter_get_child_exited(), DBUS_ERROR_FAILED, DBUS_ERROR_NO_MEMORY, DBUS_ERROR_SPAWN_CHILD_EXITED, DBUS_ERROR_SPAWN_CHILD_SIGNALED, DBUS_ERROR_SPAWN_EXEC_FAILED, dbus_set_error(), DBusBabysitter::errnum, DBusBabysitter::have_child_status, DBusBabysitter::have_exec_errnum, DBusBabysitter::have_fork_errnum, DBusBabysitter::log_name, and DBusBabysitter::status.

◆ _dbus_babysitter_set_result_function()

void _dbus_babysitter_set_result_function	(	DBusBabysitter *	sitter,
		DBusBabysitterFinishedFunc	finished,
		void *	user_data
	)

Definition at line 1527 of file dbus-spawn-unix.c.

◆ _dbus_babysitter_set_watch_functions()

dbus_bool_t _dbus_babysitter_set_watch_functions	(	DBusBabysitter *	sitter,
		DBusAddWatchFunction	add_function,
		DBusRemoveWatchFunction	remove_function,
		DBusWatchToggledFunction	toggled_function,
		void *	data,
		DBusFreeFunction	free_data_function
	)

Sets watch functions to notify us when the babysitter object needs to read/write file descriptors.

Parameters

sitter	the babysitter
add_function	function to begin monitoring a new descriptor.
remove_function	function to stop monitoring a descriptor.
toggled_function	function to notify when the watch is enabled/disabled
data	data to pass to add_function and remove_function.
free_data_function	function to be called to free the data.

Returns: FALSE on failure (no memory)

Definition at line 833 of file dbus-spawn-unix.c.

References _dbus_watch_list_set_functions(), and DBusBabysitter::watches.

◆ _dbus_babysitter_unref()

void _dbus_babysitter_unref ( DBusBabysitter * sitter )

Decrement the reference count on the babysitter object.

When the reference count of the babysitter object reaches zero, the babysitter is killed and the child that was being babysat gets emancipated.

Parameters

sitter the babysitter

Definition at line 334 of file dbus-spawn-unix.c.

References _dbus_assert, NULL, and DBusBabysitter::refcount.

◆ _dbus_become_daemon()

dbus_bool_t _dbus_become_daemon	(	const DBusString *	pidfile,
		DBusPipe *	print_pid_pipe,
		DBusError *	error,
		dbus_bool_t	keep_umask
	)

Does the chdir, fork, setsid, etc.

to become a daemon process.

Parameters

pidfile	NULL, or pidfile to create
print_pid_pipe	pipe to print daemon's pid to, or -1 for none
error	return location for errors
keep_umask	TRUE to keep the original umask

Returns: FALSE on failure

Definition at line 84 of file dbus-sysdeps-util-unix.c.

References _dbus_error_from_errno(), DBUS_ERROR_FAILED, dbus_set_error(), and FALSE.

◆ _dbus_change_to_daemon_user()

dbus_bool_t _dbus_change_to_daemon_user	(	const char *	user,
		DBusError *	error
	)

Changes the user and group the bus is running as.

Parameters

user	the user to become
error	return location for errors

Returns: FALSE on failure

Definition at line 332 of file dbus-sysdeps-util-unix.c.

References _dbus_error_from_errno(), _dbus_get_user_id_and_primary_group(), _dbus_string_init_const(), _dbus_warn(), DBUS_ERROR_FAILED, dbus_set_error(), FALSE, NULL, and TRUE.

◆ _dbus_combine_tcp_errors()

void _dbus_combine_tcp_errors	(	DBusList **	sources,
		const char *	summary,
		const char *	host,
		const char *	port,
		DBusError *	dest
	)

Definition at line 911 of file dbus-sysdeps.c.

◆ _dbus_credentials_add_from_user()

dbus_bool_t _dbus_credentials_add_from_user	(	DBusCredentials *	credentials,
		const DBusString *	username,
		DBusCredentialsAddFlags	flags,
		DBusError *	error
	)

Adds the credentials corresponding to the given username.

Used among other purposes to parses a desired identity provided from a client in the auth protocol. On UNIX this means parsing a UID, on Windows probably parsing an SID string.

Parameters

credentials	credentials to fill in
username	the username

Returns: TRUE if the username existed and we got some credentials

Definition at line 523 of file dbus-userdb.c.

References _dbus_is_a_number(), and DBUS_UID_UNSET.

◆ _dbus_directory_close()

void _dbus_directory_close ( DBusDirIter * iter )

Closes a directory iteration.

Definition at line 783 of file dbus-sysdeps-util-unix.c.

References DBusDirIter::d, and dbus_free().

◆ _dbus_directory_get_next_file()

dbus_bool_t _dbus_directory_get_next_file	(	DBusDirIter *	iter,
		DBusString *	filename,
		DBusError *	error
	)

Get next file in the directory.

Will not return "." or ".." on UNIX. If an error occurs, the contents of "filename" are undefined. The error is never set if the function succeeds.

This function is not re-entrant, and not necessarily thread-safe. Only use it for test code or single-threaded utilities.

Parameters

iter	the iterator
filename	string to be set to the next file in the dir
error	return location for error

Returns: TRUE if filename was filled in with a new filename

Definition at line 735 of file dbus-sysdeps-util-unix.c.

References _dbus_error_from_errno(), _dbus_string_append(), _dbus_string_set_length(), DBusDirIter::d, DBUS_ERROR_NO_MEMORY, dbus_set_error(), FALSE, and TRUE.

◆ _dbus_directory_open()

DBusDirIter * _dbus_directory_open	(	const DBusString *	filename,
		DBusError *	error
	)

Open a directory to iterate over.

Parameters

filename	the directory name
error	exception return object or NULL

Returns: new iterator, or NULL on error

Definition at line 687 of file dbus-sysdeps-util-unix.c.

References _dbus_error_from_errno(), DBusDirIter::d, DBUS_ERROR_NO_MEMORY, dbus_new0, dbus_set_error(), and NULL.

◆ _dbus_dup_string_array()

char ** _dbus_dup_string_array ( const char ** array )

Duplicates a string array.

Result may be freed with dbus_free_string_array(). Returns NULL if memory allocation fails. If the array to be duplicated is NULL, returns NULL.

Parameters

array array to duplicate.

Returns: newly-allocated copy.

Definition at line 640 of file dbus-internals.c.

◆ _dbus_error_from_errno()

const char * _dbus_error_from_errno ( int error_number )

Converts a UNIX errno, or Windows errno or WinSock error value into a DBusError name.

Parameters

error_number the errno.

Returns: an error name

Definition at line 599 of file dbus-sysdeps.c.

References DBUS_ERROR_ACCESS_DENIED, DBUS_ERROR_ADDRESS_IN_USE, DBUS_ERROR_FAILED, DBUS_ERROR_FILE_EXISTS, DBUS_ERROR_FILE_NOT_FOUND, DBUS_ERROR_LIMITS_EXCEEDED, DBUS_ERROR_NO_MEMORY, DBUS_ERROR_NO_NETWORK, DBUS_ERROR_NO_SERVER, DBUS_ERROR_NOT_SUPPORTED, and DBUS_ERROR_TIMEOUT.

Referenced by _dbus_become_daemon(), _dbus_change_to_daemon_user(), _dbus_check_dir_is_private_to_user(), _dbus_close(), _dbus_close_socket(), _dbus_command_for_pid(), _dbus_connect_exec(), _dbus_directory_get_next_file(), _dbus_directory_open(), _dbus_dup(), _dbus_error_from_system_errno(), _dbus_file_get_contents(), _dbus_generate_random_bytes(), _dbus_is_console_user(), _dbus_listen_systemd_sockets(), _dbus_listen_tcp_socket(), _dbus_send_credentials_socket(), _dbus_set_socket_nonblocking(), _dbus_socketpair(), _dbus_stat(), and _dbus_string_save_to_file().

◆ _dbus_error_from_system_errno()

const char * _dbus_error_from_system_errno ( void )

Converts the current system errno value into a DBusError name.

Returns: an error name

Definition at line 691 of file dbus-sysdeps.c.

References _dbus_error_from_errno().

◆ _dbus_file_exists()

dbus_bool_t _dbus_file_exists ( const char * file )

Checks if a file exists.

File interface.

Parameters

file	full path to the file

Returns: TRUE if file exists

Definition at line 563 of file dbus-sysdeps-util-unix.c.

Referenced by _dbus_user_at_console().

◆ _dbus_generate_random_ascii()

dbus_bool_t _dbus_generate_random_ascii	(	DBusString *	str,
		int	n_bytes,
		DBusError *	error
	)

Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII subset.

Parameters

str	the string
n_bytes	the number of random ASCII bytes to append to string
error	location to store reason for failure

Returns: TRUE on success, FALSE if no memory or other failure

Definition at line 559 of file dbus-sysdeps.c.

References _dbus_assert, _dbus_generate_random_bytes(), _dbus_string_validate_ascii(), FALSE, and TRUE.

Referenced by _dbus_server_listen_platform_specific(), and _dbus_string_save_to_file().

◆ _dbus_generate_random_bytes_buffer()

dbus_bool_t _dbus_generate_random_bytes_buffer	(	char *	buffer,
		int	n_bytes,
		DBusError *	error
	)

Fills n_bytes of the given buffer with random bytes.

Random numbers.

Parameters

buffer	an allocated buffer
n_bytes	the number of bytes in buffer to write to
error	location to store reason for failure

Returns: TRUE on success

Definition at line 525 of file dbus-sysdeps.c.

References _dbus_generate_random_bytes(), _dbus_string_copy_to_buffer(), _dbus_string_free(), _dbus_string_init(), FALSE, and TRUE.

Referenced by _dbus_generate_uuid().

◆ _dbus_generate_uuid()

dbus_bool_t _dbus_generate_uuid	(	DBusGUID *	uuid,
		DBusError *	error
	)

Generates a new UUID.

If you change how this is done, there's some text about it in the spec that should also change.

Parameters

uuid	the uuid to initialize
error	location to store reason for failure

Returns: TRUE on success

Definition at line 720 of file dbus-internals.c.

References _dbus_generate_random_bytes_buffer(), _dbus_get_real_time(), DBusGUID::as_bytes, DBusGUID::as_uint32s, dbus_error_free(), dbus_error_init(), dbus_set_error(), FALSE, DBusError::message, DBusError::name, NULL, and TRUE.

Referenced by _dbus_create_uuid(), _dbus_read_local_machine_uuid(), and _dbus_server_init_base().

◆ _dbus_get_group_id()

dbus_bool_t _dbus_get_group_id	(	const DBusString *	groupname,
		dbus_gid_t *	gid
	)

Gets group ID given groupname.

Parameters

groupname	the groupname
gid	return location for GID

Returns: TRUE if group name existed and we got the GID

Definition at line 176 of file dbus-userdb-util.c.

References _dbus_user_database_get_system(), _dbus_user_database_lock_system(), _dbus_user_database_lookup_group(), _dbus_user_database_unlock_system(), DBUS_GID_UNSET, FALSE, DBusGroupInfo::gid, NULL, and TRUE.

Referenced by _dbus_parse_unix_group_from_config().

◆ _dbus_get_is_errno_eintr()

dbus_bool_t _dbus_get_is_errno_eintr ( int e )

See if errno is EINTR.

Returns: TRUE if e == EINTR

Definition at line 724 of file dbus-sysdeps.c.

◆ _dbus_get_is_errno_enomem()

dbus_bool_t _dbus_get_is_errno_enomem ( int e )

See if errno is ENOMEM.

Returns: TRUE if e == ENOMEM

Definition at line 714 of file dbus-sysdeps.c.

◆ _dbus_get_is_errno_epipe()

dbus_bool_t _dbus_get_is_errno_epipe ( int e )

See if errno is EPIPE.

Returns: TRUE if errno == EPIPE

Definition at line 734 of file dbus-sysdeps.c.

◆ _dbus_get_is_errno_etoomanyrefs()

dbus_bool_t _dbus_get_is_errno_etoomanyrefs ( int e )

See if errno is ETOOMANYREFS.

Returns: TRUE if errno == ETOOMANYREFS

Definition at line 744 of file dbus-sysdeps.c.

References FALSE.

◆ _dbus_get_local_machine_uuid_encoded()

dbus_bool_t _dbus_get_local_machine_uuid_encoded	(	DBusString *	uuid_str,
		DBusError *	error
	)

Gets the hex-encoded UUID of the machine this function is executed on.

This UUID is guaranteed to be the same for a given machine at least until it next reboots, though it also makes some effort to be the same forever, it may change if the machine is reconfigured or its hardware is modified.

Parameters

uuid_str	string to append hex-encoded machine uuid to
error	location to store reason for failure

Returns: TRUE if successful

Definition at line 951 of file dbus-internals.c.

References _DBUS_LOCK, and TRUE.

Referenced by _dbus_get_autolaunch_address(), and dbus_try_get_local_machine_id().

◆ _dbus_get_user_id()

dbus_bool_t _dbus_get_user_id	(	const DBusString *	username,
		dbus_uid_t *	uid
	)

Gets user ID given username.

Parameters

username	the username
uid	return location for UID

Returns: TRUE if username existed and we got the UID

Definition at line 162 of file dbus-userdb-util.c.

References _dbus_get_user_id_and_primary_group(), and NULL.

Referenced by _dbus_parse_unix_user_from_config().

◆ _dbus_get_user_id_and_primary_group()

dbus_bool_t _dbus_get_user_id_and_primary_group	(	const DBusString *	username,
		dbus_uid_t *	uid_p,
		dbus_gid_t *	gid_p
	)

Gets user ID and primary group given username.

Parameters

username	the username
uid_p	return location for UID
gid_p	return location for GID

Returns: TRUE if username existed and we got the UID and GID

Definition at line 217 of file dbus-userdb-util.c.

References _dbus_user_database_get_system(), _dbus_user_database_get_username(), _dbus_user_database_lock_system(), _dbus_user_database_unlock_system(), FALSE, NULL, DBusUserInfo::primary_gid, TRUE, and DBusUserInfo::uid.

Referenced by _dbus_change_to_daemon_user(), _dbus_get_user_id(), and _dbus_verify_daemon_user().

◆ _dbus_group_info_fill()

dbus_bool_t _dbus_group_info_fill	(	DBusGroupInfo *	info,
		const DBusString *	groupname,
		DBusError *	error
	)

Initializes the given DBusGroupInfo struct with information about the given group name.

Parameters

info	the group info struct
groupname	name of group
error	the error return

Returns: FALSE if error is set

Definition at line 930 of file dbus-sysdeps-util-unix.c.

Referenced by _dbus_user_database_lookup_group().

◆ _dbus_group_info_fill_gid()

dbus_bool_t _dbus_group_info_fill_gid	(	DBusGroupInfo *	info,
		dbus_gid_t	gid,
		DBusError *	error
	)

Initializes the given DBusGroupInfo struct with information about the given group ID.

Parameters

info	the group info struct
gid	group ID
error	the error return

Returns: FALSE if error is set

Definition at line 949 of file dbus-sysdeps-util-unix.c.

Referenced by _dbus_user_database_lookup_group().

◆ _dbus_group_info_free()

void _dbus_group_info_free ( DBusGroupInfo * info )

Frees the members of info (but not info itself).

Parameters

info	the group info

Definition at line 119 of file dbus-userdb.c.

References dbus_free(), and DBusGroupInfo::groupname.

Referenced by _dbus_group_info_unref().

◆ _dbus_group_info_unref()

void _dbus_group_info_unref ( DBusGroupInfo * info )

Decrements the reference count.

If it reaches 0, frees the given DBusGroupInfo's members with _dbus_group_info_free() and also calls dbus_free() on the block itself

Parameters

info the info

Definition at line 85 of file dbus-userdb.c.

References _dbus_assert, _dbus_group_info_free(), dbus_free(), NULL, and DBusGroupInfo::refcount.

Referenced by _dbus_user_database_lookup_group(), and _dbus_user_database_new().

◆ _dbus_groups_from_uid()

dbus_bool_t _dbus_groups_from_uid	(	dbus_uid_t	uid,
		dbus_gid_t **	group_ids,
		int *	n_group_ids,
		DBusError *	error
	)

Gets all groups corresponding to the given UID.

Returns FALSE if no memory, or user isn't known, but always initializes group_ids to a NULL array.

Parameters

uid	the UID
group_ids	return location for array of group IDs
n_group_ids	return location for length of returned array
error	error to fill in on failure

Returns: TRUE if the UID existed and we got some credentials

Definition at line 380 of file dbus-userdb-util.c.

References _dbus_assert, _dbus_user_database_get_system(), _dbus_user_database_get_uid(), _dbus_user_database_lock_system(), _dbus_user_database_unlock_system(), dbus_new, FALSE, DBusUserInfo::group_ids, DBusUserInfo::n_group_ids, NULL, TRUE, and DBusUserInfo::uid.

Referenced by _dbus_unix_groups_from_uid().

◆ _dbus_homedir_from_current_process()

dbus_bool_t _dbus_homedir_from_current_process ( const DBusString ** homedir )

Gets homedir of user owning current process.

The returned string is valid until dbus_shutdown() is called.

Parameters

homedir place to store pointer to homedir

Returns: FALSE if no memory

Definition at line 440 of file dbus-userdb.c.

References _dbus_user_database_lock_system(), and FALSE.

Referenced by _dbus_get_standard_session_servicedirs().

◆ _dbus_homedir_from_uid()

dbus_bool_t _dbus_homedir_from_uid	(	dbus_uid_t	uid,
		DBusString *	homedir
	)

Gets the home directory for the given user.

Parameters

uid	the uid
homedir	string to append home directory to

Returns: TRUE if user existed and we appended their homedir

Definition at line 464 of file dbus-userdb.c.

References _dbus_getenv(), _dbus_geteuid(), _dbus_getuid(), _dbus_string_append(), _dbus_user_database_get_system(), _dbus_user_database_get_uid(), _dbus_user_database_lock_system(), _dbus_user_database_unlock_system(), FALSE, DBusUserInfo::homedir, NULL, and TRUE.

Referenced by _dbus_append_keyring_directory_for_credentials().

◆ _dbus_inet_sockaddr_to_string()

dbus_bool_t _dbus_inet_sockaddr_to_string	(	const void *	sockaddr_pointer,
		size_t	len,
		char *	string,
		size_t	string_len,
		const char **	family_name,
		dbus_uint16_t *	port,
		DBusError *	error
	)

Definition at line 796 of file dbus-sysdeps.c.

◆ _dbus_is_a_number()

dbus_bool_t _dbus_is_a_number	(	const DBusString *	str,
		unsigned long *	num
	)

Checks if a given string is actually a number and converts it if it is.

Parameters

str	the string to check
num	the memory location of the unsigned long to fill in

Returns: TRUE if str is a number and num is filled in

Definition at line 133 of file dbus-userdb.c.

References _dbus_string_parse_uint(), FALSE, and TRUE.

Referenced by _dbus_credentials_add_from_user(), _dbus_user_database_lookup(), and _dbus_user_database_lookup_group().

◆ _dbus_is_console_user()

dbus_bool_t _dbus_is_console_user	(	dbus_uid_t	uid,
		DBusError *	error
	)

Checks to see if the UID sent in is the console user.

Parameters

uid	UID of person to check
error	return location for errors

Returns: TRUE if the UID is the same as the console user and there are no errors

Definition at line 65 of file dbus-userdb-util.c.

References _dbus_error_from_errno(), _dbus_stat(), _dbus_string_append(), _dbus_string_free(), _dbus_string_init(), _dbus_user_at_console(), _dbus_user_database_get_system(), _dbus_user_database_lock_system(), _dbus_user_database_lookup(), _dbus_user_database_unlock_system(), DBUS_ERROR_FAILED, dbus_set_error(), DBUS_UID_FORMAT, FALSE, NULL, TRUE, DBusStat::uid, and DBusUserInfo::username.

Referenced by _dbus_unix_user_is_at_console().

◆ _dbus_log()

void _dbus_log	(	DBusSystemLogSeverity	severity,
		const char *	msg,
			...
	)

Log a message to the system log file (e.g.

syslog on Unix) and/or stderr.

Parameters

severity	a severity value
msg	a printf-style format string

Definition at line 770 of file dbus-sysdeps.c.

References _dbus_logv().

◆ _dbus_memdup()

void * _dbus_memdup	(	const void *	mem,
		size_t	n_bytes
	)

Duplicates a block of memory.

Returns NULL on failure.

Parameters

mem	memory to copy
n_bytes	number of bytes to copy

Returns: the copy

Definition at line 617 of file dbus-internals.c.

Referenced by _dbus_decompose_path().

◆ _dbus_parse_unix_group_from_config()

dbus_bool_t _dbus_parse_unix_group_from_config	(	const DBusString *	groupname,
		dbus_gid_t *	gid_p
	)

Parse a UNIX group from the bus config file.

On Windows, this should simply always fail (just return FALSE).

Parameters

groupname	the groupname text
gid_p	place to return the gid

Returns: TRUE on success

Definition at line 981 of file dbus-sysdeps-util-unix.c.

References _dbus_get_group_id().

◆ _dbus_parse_unix_user_from_config()

dbus_bool_t _dbus_parse_unix_user_from_config	(	const DBusString *	username,
		dbus_uid_t *	uid_p
	)

Parse a UNIX user from the bus config file.

On Windows, this should simply always fail (just return FALSE).

Parameters

username	the username text
uid_p	place to return the uid

Returns: TRUE on success

Definition at line 965 of file dbus-sysdeps-util-unix.c.

References _dbus_get_user_id().

◆ _dbus_path_is_absolute()

dbus_bool_t _dbus_path_is_absolute ( const DBusString * filename )

Checks whether the filename is an absolute path.

Parameters

filename the filename

Returns: TRUE if an absolute path

Definition at line 622 of file dbus-sysdeps-util-unix.c.

References FALSE.

◆ _dbus_read_uuid_file()

dbus_bool_t _dbus_read_uuid_file	(	const DBusString *	filename,
		DBusGUID *	uuid,
		dbus_bool_t	create_if_not_found,
		DBusError *	error
	)

Reads (and optionally writes) a uuid to a file.

Initializes the uuid unless an error is returned.

Parameters

filename	the name of the file
uuid	uuid to be initialized with the loaded uuid
create_if_not_found	TRUE to create a new uuid and save it if the file doesn't exist
error	the error return

Returns: FALSE if the error is set

Definition at line 899 of file dbus-internals.c.

References DBUS_ERROR_INIT.

Referenced by _dbus_get_uuid(), and _dbus_read_local_machine_uuid().

◆ _dbus_real_assert()

void _dbus_real_assert	(	dbus_bool_t	condition,
		const char *	condition_text,
		const char *	file,
		int	line,
		const char *	func
	)

Internals of _dbus_assert(); it's a function rather than a macro with the inline code so that the assertion failure blocks don't show up in test suite coverage, and to shrink code size.

Parameters

condition	TRUE if assertion succeeded
condition_text	condition as a string
file	file the assertion is in
line	line the assertion is in
func	function the assertion is in

Definition at line 1010 of file dbus-internals.c.

References _dbus_abort(), and _dbus_warn().

◆ _dbus_real_assert_not_reached()

void _dbus_real_assert_not_reached	(	const char *	explanation,
		const char *	file,
		int	line
	)

Internals of _dbus_assert_not_reached(); it's a function rather than a macro with the inline code so that the assertion failure blocks don't show up in test suite coverage, and to shrink code size.

Parameters

explanation	what was reached that shouldn't have been
file	file the assertion is in
line	line the assertion is in

Definition at line 1035 of file dbus-internals.c.

References _dbus_abort(), and _dbus_warn().

◆ _dbus_rlimit_free()

void _dbus_rlimit_free ( DBusRLimit * lim )

Definition at line 533 of file dbus-sysdeps-util-unix.c.

◆ _dbus_rlimit_raise_fd_limit()

dbus_bool_t _dbus_rlimit_raise_fd_limit ( DBusError * error )

Definition at line 516 of file dbus-sysdeps-util-unix.c.

◆ _dbus_rlimit_restore_fd_limit()

dbus_bool_t _dbus_rlimit_restore_fd_limit	(	DBusRLimit *	saved,
		DBusError *	error
	)

Definition at line 523 of file dbus-sysdeps-util-unix.c.

◆ _dbus_rlimit_save_fd_limit()

DBusRLimit * _dbus_rlimit_save_fd_limit ( DBusError * error )

Definition at line 509 of file dbus-sysdeps-util-unix.c.

◆ _dbus_set_errno_to_zero()

void _dbus_set_errno_to_zero ( void )

Assign 0 to the global errno variable.

Definition at line 700 of file dbus-sysdeps.c.

Referenced by _dbus_string_parse_int(), and _dbus_string_parse_uint().

◆ _dbus_set_error_with_inet_sockaddr()

void _dbus_set_error_with_inet_sockaddr	(	DBusError *	error,
		const void *	sockaddr_pointer,
		size_t	len,
		const char *	description,
		int	saved_errno
	)

Definition at line 883 of file dbus-sysdeps.c.

◆ _dbus_set_signal_handler()

void _dbus_set_signal_handler	(	int	sig,
		DBusSignalHandler	handler
	)

Installs a UNIX signal handler.

Parameters

sig	the signal to handle
handler	the handler

Definition at line 544 of file dbus-sysdeps-util-unix.c.

References NULL.

◆ _dbus_spawn_async_with_babysitter()

dbus_bool_t _dbus_spawn_async_with_babysitter	(	DBusBabysitter **	sitter_p,
		const char *	log_name,
		char const	argv,
		char const	env,
		DBusSpawnFlags flags	flags,
		DBusSpawnChildSetupFunc child_setup	child_setup,
		void *	user_data,
		DBusError *	error
	)

Spawns a new process.

On Unix platforms, the child_setup function is passed the given user_data and is run in the child after fork() but before calling exec(). This can be used to change uid, resource limits and so on. On Windows, this functionality does not fit the multi-processing model (Windows does the equivalent of fork() and exec() in a single API call), and the child_setup function and its user_data are ignored.

Also creates a "babysitter" which tracks the status of the child process, advising the parent if the child exits. If the spawn fails, no babysitter is created. If sitter_p is NULL, no babysitter is kept.

Parameters

sitter_p	return location for babysitter or NULL
log_name	the name under which to log messages about this process being spawned
argv	the executable and arguments
env	the environment, or NULL to copy the parent's
child_setup	function to call in child pre-exec()
user_data	user data for setup function
error	error object to be filled in if function fails

Returns: TRUE on success, FALSE if error is filled in

Definition at line 1271 of file dbus-spawn-unix.c.

◆ _dbus_stat()

dbus_bool_t _dbus_stat	(	const DBusString *	filename,
		DBusStat *	statbuf,
		DBusError *	error
	)

stat() wrapper.

Parameters

filename	the filename to stat
statbuf	the stat info to fill in
error	return location for error

Returns: FALSE if error was set

Definition at line 639 of file dbus-sysdeps-util-unix.c.

References _dbus_error_from_errno(), DBusStat::atime, DBusStat::ctime, dbus_set_error(), FALSE, DBusStat::gid, DBusStat::mode, DBusStat::mtime, DBusStat::nlink, DBusStat::size, TRUE, and DBusStat::uid.

Referenced by _dbus_is_console_user().

◆ _dbus_strdup()

char * _dbus_strdup ( const char * str )

Duplicates a string.

Result must be freed with dbus_free(). Returns NULL if memory allocation fails. If the string to be duplicated is NULL, returns NULL.

Parameters

str	string to duplicate.

Returns: newly-allocated copy.

Definition at line 589 of file dbus-internals.c.

Referenced by _dbus_get_environment(), _dbus_message_iter_get_args_valist(), _dbus_server_new_for_domain_socket(), _dbus_transport_get_windows_user(), _dbus_transport_open(), _dbus_transport_open_platform_specific(), dbus_bus_get_id(), dbus_connection_get_server_id(), and dbus_server_get_address().

◆ _dbus_strerror_from_errno()

const char * _dbus_strerror_from_errno ( void )

Get error message from errno.

Returns: _dbus_strerror(errno)

Definition at line 758 of file dbus-sysdeps.c.

Referenced by _dbus_close_socket(), _dbus_create_directory(), _dbus_delete_file(), _dbus_ensure_directory(), _dbus_send_credentials_socket(), _dbus_set_socket_nonblocking(), _dbus_socketpair(), _dbus_write_socket(), and _dbus_write_socket_two().

◆ _dbus_string_array_contains()

dbus_bool_t _dbus_string_array_contains	(	const char **	array,
		const char *	str
	)

Checks whether a string array contains the given string.

Parameters

array	array to search.
str	string to look for

Returns: TRUE if array contains string

Definition at line 680 of file dbus-internals.c.

References FALSE, NULL, and TRUE.

◆ _dbus_string_array_length()

size_t _dbus_string_array_length ( const char ** array )

Returns the size of a string array.

Parameters

array array to search.

Returns: size of array

Definition at line 703 of file dbus-internals.c.

◆ _dbus_unix_groups_from_uid()

dbus_bool_t _dbus_unix_groups_from_uid	(	dbus_uid_t	uid,
		dbus_gid_t **	group_ids,
		int *	n_group_ids,
		DBusError *	error
	)

Gets all groups corresponding to the given UNIX user ID.

On UNIX, just calls _dbus_groups_from_uid(). On Windows, should always fail since we don't know any UNIX groups.

Parameters

uid	the UID
group_ids	return location for array of group IDs
n_group_ids	return location for length of returned array
error	error location

Returns: TRUE if the UID existed and we got some credentials

Definition at line 999 of file dbus-sysdeps-util-unix.c.

References _dbus_groups_from_uid().

◆ _dbus_unix_user_is_at_console()

dbus_bool_t _dbus_unix_user_is_at_console	(	dbus_uid_t	uid,
		DBusError *	error
	)

Checks to see if the UNIX user ID is at the console.

Should always fail on Windows (set the error to DBUS_ERROR_NOT_SUPPORTED).

Parameters

uid	UID of person to check
error	return location for errors

Returns: TRUE if the UID is the same as the console user and there are no errors

Definition at line 1017 of file dbus-sysdeps-util-unix.c.

References _dbus_is_console_user().

◆ _dbus_unix_user_is_process_owner()

dbus_bool_t _dbus_unix_user_is_process_owner ( dbus_uid_t uid )

Checks to see if the UNIX user ID matches the UID of the process.

Should always return FALSE on Windows.

Parameters

uid	the UNIX user ID

Returns: TRUE if this uid owns the process.

Definition at line 1032 of file dbus-sysdeps-util-unix.c.

References _dbus_geteuid().

◆ _dbus_user_at_console()

dbus_bool_t _dbus_user_at_console	(	const char *	username,
		DBusError *	error
	)

Checks if user is at the console.

Parameters

username	user to check
error	return location for errors

Returns: TRUE is the user is at the consolei and there are no errors

Definition at line 575 of file dbus-sysdeps-util-unix.c.

References _dbus_concat_dir_and_file(), _dbus_file_exists(), _dbus_string_append(), _dbus_string_free(), _dbus_string_init(), _dbus_string_init_const(), and FALSE.

Referenced by _dbus_is_console_user().

◆ _dbus_user_database_flush()

void _dbus_user_database_flush ( DBusUserDatabase * db )

Flush all information out of the user database.

Definition at line 639 of file dbus-userdb.c.

References _dbus_hash_table_remove_all().

◆ _dbus_user_database_flush_system()

void _dbus_user_database_flush_system ( void )

Flushes the system global user database;.

Definition at line 394 of file dbus-userdb.c.

References _dbus_user_database_lock_system().

Referenced by _dbus_flush_caches().

◆ _dbus_user_database_get_system()

DBusUserDatabase * _dbus_user_database_get_system ( void )

Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system()).

Returns: the database or NULL if no memory

Definition at line 381 of file dbus-userdb.c.

References _dbus_assert.

Referenced by _dbus_get_group_id(), _dbus_get_user_id_and_primary_group(), _dbus_groups_from_uid(), _dbus_homedir_from_uid(), and _dbus_is_console_user().

◆ _dbus_user_database_get_uid()

dbus_bool_t _dbus_user_database_get_uid	(	DBusUserDatabase *	db,
		dbus_uid_t	uid,
		const DBusUserInfo **	info,
		DBusError *	error
	)

Gets the user information for the given UID, returned user info should not be freed.

Parameters

db	user database
uid	the user ID
info	return location for const ref to user info
error	error location

Returns: FALSE if error is set

Definition at line 703 of file dbus-userdb.c.

References _dbus_user_database_lookup(), and NULL.

Referenced by _dbus_groups_from_uid(), and _dbus_homedir_from_uid().

◆ _dbus_user_database_get_username()

dbus_bool_t _dbus_user_database_get_username	(	DBusUserDatabase *	db,
		const DBusString *	username,
		const DBusUserInfo **	info,
		DBusError *	error
	)

Gets the user information for the given username.

Parameters

db	user database
username	the user name
info	return location for const ref to user info
error	error location

Returns: FALSE if error is set

Definition at line 722 of file dbus-userdb.c.

References _dbus_user_database_lookup(), DBUS_UID_UNSET, and NULL.

Referenced by _dbus_get_user_id_and_primary_group().

◆ _dbus_user_database_lock_system()

dbus_bool_t _dbus_user_database_lock_system ( void )

Locks global system user database.

Definition at line 351 of file dbus-userdb.c.

References _DBUS_LOCK.

Referenced by _dbus_get_group_id(), _dbus_get_user_id_and_primary_group(), _dbus_groups_from_uid(), _dbus_homedir_from_current_process(), _dbus_homedir_from_uid(), _dbus_is_console_user(), _dbus_user_database_flush_system(), and _dbus_username_from_current_process().

◆ _dbus_user_database_lookup()

const DBusUserInfo * _dbus_user_database_lookup	(	DBusUserDatabase *	db,
		dbus_uid_t	uid,
		const DBusString *	username,
		DBusError *	error
	)

Looks up a uid or username in the user database.

Only one of name or UID can be provided. There are wrapper functions for this that are better to use, this one does no locking or anything on the database and otherwise sort of sucks.

Parameters

db	the database
uid	the user ID or DBUS_UID_UNSET
username	username or NULL
error	error to fill in

Returns: the entry in the database (borrowed, do not free)

Definition at line 158 of file dbus-userdb.c.

References _dbus_assert, _dbus_hash_table_insert_uintptr(), _dbus_hash_table_lookup_string(), _dbus_hash_table_lookup_uintptr(), _dbus_is_a_number(), _dbus_user_info_fill(), _dbus_user_info_fill_uid(), _dbus_user_info_unref(), DBUS_ERROR_NO_MEMORY, dbus_new0, dbus_set_error(), DBUS_UID_FORMAT, DBUS_UID_UNSET, NULL, DBusUserInfo::refcount, and DBusUserInfo::uid.

Referenced by _dbus_is_console_user(), _dbus_user_database_get_uid(), and _dbus_user_database_get_username().

◆ _dbus_user_database_lookup_group()

const DBusGroupInfo * _dbus_user_database_lookup_group	(	DBusUserDatabase *	db,
		dbus_gid_t	gid,
		const DBusString *	groupname,
		DBusError *	error
	)

Looks up a gid or group name in the user database.

Only one of name or GID can be provided. There are wrapper functions for this that are better to use, this one does no locking or anything on the database and otherwise sort of sucks.

Parameters

db	the database
gid	the group ID or DBUS_GID_UNSET
groupname	group name or NULL
error	error to fill in

Returns: the entry in the database (borrowed, do not free)

Definition at line 264 of file dbus-userdb-util.c.

References _dbus_group_info_fill(), _dbus_group_info_fill_gid(), _dbus_group_info_unref(), _dbus_hash_table_insert_uintptr(), _dbus_hash_table_lookup_string(), _dbus_hash_table_lookup_uintptr(), _dbus_is_a_number(), DBUS_ERROR_NO_MEMORY, DBUS_GID_FORMAT, DBUS_GID_UNSET, dbus_new0, dbus_set_error(), DBUS_UID_UNSET, DBusGroupInfo::gid, NULL, and DBusGroupInfo::refcount.

Referenced by _dbus_get_group_id().

◆ _dbus_user_database_new()

DBusUserDatabase * _dbus_user_database_new ( void )

Creates a new user database object used to look up and cache user information.

Returns: new database, or NULL on out of memory

Definition at line 596 of file dbus-userdb.c.

References _dbus_group_info_unref(), _dbus_hash_table_new(), _dbus_user_database_unref(), _dbus_user_info_unref(), DBUS_HASH_STRING, DBUS_HASH_UINTPTR, dbus_new0, and NULL.

◆ _dbus_user_database_unlock_system()

void _dbus_user_database_unlock_system ( void )

Unlocks global system user database.

Definition at line 368 of file dbus-userdb.c.

Referenced by _dbus_get_group_id(), _dbus_get_user_id_and_primary_group(), _dbus_groups_from_uid(), _dbus_homedir_from_uid(), and _dbus_is_console_user().

◆ _dbus_user_database_unref()

void _dbus_user_database_unref ( DBusUserDatabase * db )

Decrements refcount of user database.

Parameters

db	the database

Definition at line 669 of file dbus-userdb.c.

References _dbus_assert, _dbus_hash_table_unref(), and dbus_free().

Referenced by _dbus_user_database_new().

◆ _dbus_user_info_free()

void _dbus_user_info_free ( DBusUserInfo * info )

Frees the members of info (but not info itself)

Parameters

info	the user info struct

Definition at line 106 of file dbus-userdb.c.

References dbus_free(), DBusUserInfo::group_ids, DBusUserInfo::homedir, and DBusUserInfo::username.

Referenced by _dbus_user_info_unref().

◆ _dbus_user_info_unref()

void _dbus_user_info_unref ( DBusUserInfo * info )

Decrements the reference count.

If it reaches 0, frees the given DBusUserInfo's members with _dbus_user_info_free() and also calls dbus_free() on the block itself

Parameters

info the info

Definition at line 62 of file dbus-userdb.c.

References _dbus_assert, _dbus_user_info_free(), dbus_free(), NULL, and DBusUserInfo::refcount.

Referenced by _dbus_user_database_lookup(), and _dbus_user_database_new().

◆ _dbus_username_from_current_process()

dbus_bool_t _dbus_username_from_current_process ( const DBusString ** username )

Gets username of user owning current process.

The returned string is valid until dbus_shutdown() is called.

Parameters

username place to store pointer to username

Returns: FALSE if no memory

Definition at line 416 of file dbus-userdb.c.

References _dbus_user_database_lock_system(), and FALSE.

◆ _dbus_uuid_encode()

dbus_bool_t _dbus_uuid_encode	(	const DBusGUID *	uuid,
		DBusString *	encoded
	)

Hex-encode a UUID.

Parameters

uuid	the uuid
encoded	string to append hex uuid to

Returns: FALSE if no memory

Definition at line 756 of file dbus-internals.c.

References _dbus_string_hex_encode(), _dbus_string_init_const_len(), and DBusGUID::as_bytes.

Referenced by _dbus_server_init_base(), and _dbus_write_uuid_file().

◆ _dbus_verify_daemon_user()

dbus_bool_t _dbus_verify_daemon_user ( const char * user )

Verify that after the fork we can successfully change to this user.

Parameters

user	the username given in the daemon configuration

Returns: TRUE if username is valid

Definition at line 312 of file dbus-sysdeps-util-unix.c.

References _dbus_get_user_id_and_primary_group(), _dbus_string_init_const(), and NULL.

◆ _dbus_warn()

void _dbus_warn	(	const char *	format,
			...
	)

Prints a warning message to stderr.

Can optionally be made to exit fatally by setting DBUS_FATAL_WARNINGS, but this is rarely used. This function should be considered pretty much equivalent to fprintf(stderr). _dbus_warn_check_failed() on the other hand is suitable for use when a programming mistake has been made.

Parameters

format printf-style format string.

Definition at line 238 of file dbus-internals.c.

Referenced by _dbus_append_keyring_directory_for_credentials(), _dbus_change_to_daemon_user(), _dbus_get_tmpdir(), _dbus_listen_tcp_socket(), _dbus_marshal_skip_basic(), _dbus_message_iter_get_args_valist(), _dbus_real_assert(), _dbus_real_assert_not_reached(), _dbus_server_new_for_launchd(), _dbus_socketpair(), dbus_malloc(), dbus_malloc0(), dbus_message_append_args_valist(), and dbus_realloc().

◆ _dbus_warn_check_failed()

void _dbus_warn_check_failed	(	const char *	format,
			...
	)

Prints a "critical" warning to stderr when an assertion fails; differs from _dbus_warn primarily in that it defaults to fatal.

This should be used only when a programming error has been detected. (NOT for unavoidable errors that an app might handle - those should be returned as DBusError.) Calling this means "there is a bug"

Definition at line 270 of file dbus-internals.c.

Referenced by _dbus_marshal_read_basic(), _dbus_transport_handle_watch(), dbus_connection_close(), dbus_connection_remove_filter(), dbus_get_local_machine_id(), dbus_server_set_timeout_functions(), and dbus_server_set_watch_functions().

◆ _dbus_warn_return_if_fail()

void _dbus_warn_return_if_fail	(	const char *	function,
		const char *	assertion,
		const char *	file,
		int	line
	)

Definition at line 984 of file dbus-internals.c.

◆ _dbus_windows_user_is_process_owner()

dbus_bool_t _dbus_windows_user_is_process_owner ( const char * windows_sid )

Checks to see if the Windows user SID matches the owner of the process.

Should always return FALSE on UNIX.

Parameters

windows_sid the Windows user SID

Returns: TRUE if this user owns the process.

Definition at line 1045 of file dbus-sysdeps-util-unix.c.

References FALSE.

◆ _dbus_write_pid_to_file_and_pipe()

dbus_bool_t _dbus_write_pid_to_file_and_pipe	(	const DBusString *	pidfile,
		DBusPipe *	print_pid_pipe,
		dbus_pid_t	pid_to_write,
		DBusError *	error
	)

Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a pipe (if non-NULL).

Does nothing if pidfile and print_pid_pipe are both NULL.

Parameters

pidfile	the file to write to or NULL
print_pid_pipe	the pipe to write to or NULL
pid_to_write	the pid to write out
error	error on failure

Returns: FALSE if error is set

Definition at line 238 of file dbus-sysdeps-util-unix.c.

◆ _dbus_write_uuid_file()

dbus_bool_t _dbus_write_uuid_file	(	const DBusString *	filename,
		const DBusGUID *	uuid,
		DBusError *	error
	)

Write the give UUID to a file.

Parameters

filename	the file to write
uuid	the UUID to save
error	used to raise an error

Returns: FALSE on error

Definition at line 850 of file dbus-internals.c.

References _dbus_string_append_byte(), _dbus_string_free(), _dbus_string_init(), _dbus_string_save_to_file(), _dbus_uuid_encode(), FALSE, and TRUE.

Referenced by _dbus_read_local_machine_uuid().

Variable Documentation

◆ _dbus_no_memory_message

const char* _dbus_no_memory_message = "Not enough memory"

Fixed "out of memory" error message, just to avoid making up a different string every time and wasting space.

Definition at line 185 of file dbus-internals.c.

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ _dbus_assert

◆ _dbus_assert_not_reached

◆ _DBUS_INT16_MAX

◆ _DBUS_INT16_MIN

◆ _DBUS_INT32_MAX

◆ _DBUS_INT32_MIN

◆ _DBUS_INT_MAX

◆ _DBUS_INT_MIN

◆ _DBUS_INT_TO_POINTER

◆ _DBUS_LOCK

◆ _DBUS_LOCK_NAME

◆ _DBUS_N_ELEMENTS

◆ _DBUS_POINTER_TO_INT

◆ _DBUS_UINT16_MAX

◆ _DBUS_UINT32_MAX

◆ _DBUS_UINT_MAX

◆ _DBUS_UNLOCK

◆ _DBUS_ZERO

◆ LIVE_CHILDREN

◆ READ_END

◆ WRITE_END

Typedef Documentation

◆ DBusForeachFunction

Enumeration Type Documentation

◆ anonymous enum

◆ ReadStatus

Function Documentation

◆ _dbus_babysitter_get_child_exit_status()

◆ _dbus_babysitter_get_child_exited()

◆ _dbus_babysitter_kill_child()

◆ _dbus_babysitter_ref()

◆ _dbus_babysitter_set_child_exit_error()

◆ _dbus_babysitter_set_result_function()

◆ _dbus_babysitter_set_watch_functions()

◆ _dbus_babysitter_unref()

◆ _dbus_become_daemon()

◆ _dbus_change_to_daemon_user()

◆ _dbus_combine_tcp_errors()

◆ _dbus_credentials_add_from_user()

◆ _dbus_directory_close()

◆ _dbus_directory_get_next_file()

◆ _dbus_directory_open()

◆ _dbus_dup_string_array()

◆ _dbus_error_from_errno()

◆ _dbus_error_from_system_errno()

◆ _dbus_file_exists()

◆ _dbus_generate_random_ascii()

◆ _dbus_generate_random_bytes_buffer()

◆ _dbus_generate_uuid()

◆ _dbus_get_group_id()

◆ _dbus_get_is_errno_eintr()

◆ _dbus_get_is_errno_enomem()

◆ _dbus_get_is_errno_epipe()

◆ _dbus_get_is_errno_etoomanyrefs()

◆ _dbus_get_local_machine_uuid_encoded()

◆ _dbus_get_user_id()

◆ _dbus_get_user_id_and_primary_group()

◆ _dbus_group_info_fill()

◆ _dbus_group_info_fill_gid()

◆ _dbus_group_info_free()

◆ _dbus_group_info_unref()

◆ _dbus_groups_from_uid()

◆ _dbus_homedir_from_current_process()

◆ _dbus_homedir_from_uid()

◆ _dbus_inet_sockaddr_to_string()

◆ _dbus_is_a_number()

◆ _dbus_is_console_user()

◆ _dbus_log()

◆ _dbus_memdup()

◆ _dbus_parse_unix_group_from_config()

◆ _dbus_parse_unix_user_from_config()

◆ _dbus_path_is_absolute()