Data Structures | |
struct | DBusBabysitter |
Babysitter implementation details. More... | |
struct | DBusDirIter |
Internals of directory iterator. More... | |
Defines | |
#define | _dbus_assert(condition) _dbus_real_assert ((condition) != 0, #condition, __FILE__, __LINE__) |
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) ((long)(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*)((long)(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_INT_MIN (-_DBUS_INT_MAX - 1) |
Minimum value of type "int". | |
#define | _DBUS_INT_MAX 2147483647 |
Maximum value of type "int". | |
#define | _DBUS_LOCK_NAME(name) _dbus_lock_##name |
Expands to name of a global lock variable. | |
#define | _DBUS_DEFINE_GLOBAL_LOCK(name) DBusMutex *_dbus_lock_##name |
Defines a global lock variable with the given name. More... | |
#define | _DBUS_DECLARE_GLOBAL_LOCK(name) extern DBusMutex *_dbus_lock_##name |
Expands to declaration of a global lock defined with _DBUS_DEFINE_GLOBAL_LOCK. More... | |
#define | _DBUS_LOCK(name) dbus_mutex_lock (_dbus_lock_##name) |
Locks a global lock. | |
#define | _DBUS_UNLOCK(name) dbus_mutex_unlock (_dbus_lock_##name) |
Unlocks a global lock. | |
#define | LIVE_CHILDREN(sitter) ((sitter)->socket_to_babysitter >= 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. | |
#define | READ_END 0 |
Helps remember which end of the pipe is which. | |
#define | WRITE_END 1 |
Helps remember which end of the pipe is which. | |
#define | _DBUS_MAX_SUN_PATH_LENGTH 99 |
Maximum length of the path to a UNIX domain socket, sockaddr_un::sun_path member. More... | |
#define | NANOSECONDS_PER_SECOND 1000000000 |
nanoseconds in a second. | |
#define | MICROSECONDS_PER_SECOND 1000000 |
microseconds in a second. | |
#define | MILLISECONDS_PER_SECOND 1000 |
milliseconds in a second. | |
#define | NANOSECONDS_PER_MILLISECOND 1000000 |
nanoseconds in a millisecond. | |
#define | MICROSECONDS_PER_MILLISECOND 1000 |
microseconds in a millisecond. | |
Typedefs | |
typedef void(* | DBusForeachFunction )(void *element, void *data) |
Used to iterate over each item in a collection, such as a DBusList. | |
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_verbose_real (const char *format,...) |
Prints a warning message to stderr if the user has enabled verbose mode. More... | |
void | _dbus_verbose_reset_real (void) |
Reinitializes the verbose logging code, used as a hack in dbus-spawn.c so that a child process re-reads its pid. | |
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... | |
const char * | _dbus_type_to_string (int type) |
Returns a string describing the given type. More... | |
const char * | _dbus_header_field_to_string (int header_field) |
Returns a string describing the given name. More... | |
void | _dbus_real_assert (dbus_bool_t condition, const char *condition_text, const char *file, int line) |
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... | |
dbus_bool_t | _dbus_test_oom_handling (const char *description, DBusTestMemoryFunction func, void *data) |
Tests how well the given function responds to out-of-memory situations. 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... | |
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, char **argv, DBusSpawnChildSetupFunc child_setup, void *user_data, DBusError *error) |
Spawns a new process. More... | |
void | _dbus_abort (void) |
Aborts the program with SIGABRT (dumping core). | |
dbus_bool_t | _dbus_setenv (const char *varname, const char *value) |
Wrapper for setenv(). More... | |
const char * | _dbus_getenv (const char *varname) |
Wrapper for getenv(). More... | |
int | _dbus_read (int fd, DBusString *buffer, int count) |
Thin wrapper around the read() system call that appends the data it reads to the DBusString buffer. More... | |
int | _dbus_write (int fd, const DBusString *buffer, int start, int len) |
Thin wrapper around the write() system call that writes a part of a DBusString and handles EINTR for you. More... | |
int | _dbus_write_two (int fd, const DBusString *buffer1, int start1, int len1, const DBusString *buffer2, int start2, int len2) |
Like _dbus_write() but will use writev() if possible to write both buffers in sequence. More... | |
int | _dbus_connect_unix_socket (const char *path, dbus_bool_t abstract, DBusError *error) |
Creates a socket and connects it to the UNIX domain socket at the given path. More... | |
int | _dbus_listen_unix_socket (const char *path, dbus_bool_t abstract, DBusError *error) |
Creates a socket and binds it to the given path, then listens on the socket. More... | |
int | _dbus_connect_tcp_socket (const char *host, dbus_uint32_t port, DBusError *error) |
Creates a socket and connects to a socket at the given host and port. More... | |
int | _dbus_listen_tcp_socket (const char *host, dbus_uint32_t port, DBusError *error) |
Creates a socket and binds it to the given path, then listens on the socket. More... | |
dbus_bool_t | _dbus_read_credentials_unix_socket (int client_fd, DBusCredentials *credentials, DBusError *error) |
Reads a single byte which must be nul (an error occurs otherwise), and reads unix credentials if available. More... | |
dbus_bool_t | _dbus_send_credentials_unix_socket (int server_fd, DBusError *error) |
Sends a single nul byte with our UNIX credentials as ancillary data. More... | |
int | _dbus_accept (int listen_fd) |
Accepts a connection on a listening socket. More... | |
dbus_bool_t | _dbus_user_info_fill (DBusUserInfo *info, const DBusString *username, DBusError *error) |
Gets user info for the given username. More... | |
dbus_bool_t | _dbus_user_info_fill_uid (DBusUserInfo *info, dbus_uid_t uid, DBusError *error) |
Gets user info for the given user ID. More... | |
void | _dbus_user_info_free (DBusUserInfo *info) |
Frees the members of info (but not info itself). 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... | |
void | _dbus_group_info_free (DBusGroupInfo *info) |
Frees the members of info (but not info itself). More... | |
void | _dbus_credentials_clear (DBusCredentials *credentials) |
Sets fields in DBusCredentials to DBUS_PID_UNSET, DBUS_UID_UNSET, DBUS_GID_UNSET. More... | |
void | _dbus_credentials_from_current_process (DBusCredentials *credentials) |
Gets the credentials of the current process. More... | |
dbus_bool_t | _dbus_credentials_match (const DBusCredentials *expected_credentials, const DBusCredentials *provided_credentials) |
Checks whether the provided_credentials are allowed to log in as the expected_credentials. More... | |
unsigned long | _dbus_getpid (void) |
Gets our process ID. More... | |
dbus_uid_t | _dbus_getuid (void) |
Gets our UID. More... | |
dbus_gid_t | _dbus_getgid (void) |
Gets our GID. More... | |
dbus_int32_t | _dbus_atomic_inc (DBusAtomic *atomic) |
Atomically increments an integer. More... | |
dbus_int32_t | _dbus_atomic_dec (DBusAtomic *atomic) |
Atomically decrement an integer. More... | |
int | _dbus_poll (DBusPollFD *fds, int n_fds, int timeout_milliseconds) |
Wrapper for poll(). More... | |
void | _dbus_sleep_milliseconds (int milliseconds) |
Sleeps the given number of milliseconds. More... | |
void | _dbus_get_current_time (long *tv_sec, long *tv_usec) |
Get current time, as in gettimeofday(). More... | |
dbus_bool_t | _dbus_file_get_contents (DBusString *str, const DBusString *filename, DBusError *error) |
Appends the contents of the given file to the string, returning error code. More... | |
dbus_bool_t | _dbus_string_save_to_file (const DBusString *str, const DBusString *filename, DBusError *error) |
Writes a string out to a file. More... | |
dbus_bool_t | _dbus_create_file_exclusively (const DBusString *filename, DBusError *error) |
Creates the given file, failing if the file already exists. More... | |
dbus_bool_t | _dbus_delete_file (const DBusString *filename, DBusError *error) |
Deletes the given file. More... | |
dbus_bool_t | _dbus_create_directory (const DBusString *filename, DBusError *error) |
Creates a directory; succeeds if the directory is created or already existed. More... | |
dbus_bool_t | _dbus_delete_directory (const DBusString *filename, DBusError *error) |
Removes a directory; Directory must be empty. More... | |
dbus_bool_t | _dbus_concat_dir_and_file (DBusString *dir, const DBusString *next_component) |
Appends the given filename to the given directory. More... | |
dbus_bool_t | _dbus_string_get_dirname (const DBusString *filename, DBusString *dirname) |
Get the directory name from a complete filename. More... | |
dbus_bool_t | _dbus_path_is_absolute (const DBusString *filename) |
Checks whether the filename is an absolute path. 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. | |
dbus_bool_t | _dbus_generate_random_bytes (DBusString *str, int n_bytes) |
Generates the given number of random bytes, using the best mechanism we can come up with. More... | |
dbus_bool_t | _dbus_generate_random_ascii (DBusString *str, int n_bytes) |
Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII subset. More... | |
const char * | _dbus_strerror (int error_number) |
A wrapper around strerror() because some platforms may be lame and not have strerror(). More... | |
void | _dbus_disable_sigpipe (void) |
signal (SIGPIPE, SIG_IGN);. | |
void | _dbus_fd_set_close_on_exec (int fd) |
Sets the file descriptor to be close on exec. More... | |
const char * | _dbus_error_from_errno (int error_number) |
Converts a UNIX errno into a DBusError name. More... | |
void | _dbus_exit (int code) |
Exit the process, returning the given value. More... | |
dbus_bool_t | _dbus_stat (const DBusString *filename, DBusStat *statbuf, DBusError *error) |
stat() wrapper. More... | |
dbus_bool_t | _dbus_full_duplex_pipe (int *fd1, int *fd2, dbus_bool_t blocking, DBusError *error) |
Creates a full-duplex pipe (as in socketpair()). More... | |
dbus_bool_t | _dbus_close (int fd, DBusError *error) |
Closes a file descriptor. More... | |
dbus_bool_t | _dbus_set_fd_nonblocking (int fd, DBusError *error) |
Sets a file descriptor to be nonblocking. More... | |
void | _dbus_print_backtrace (void) |
On GNU libc systems, print a crude backtrace to the verbose log. More... | |
dbus_bool_t | _dbus_become_daemon (const DBusString *pidfile, DBusError *error) |
Does the chdir, fork, setsid, etc. More... | |
dbus_bool_t | _dbus_write_pid_file (const DBusString *filename, unsigned long pid, DBusError *error) |
Creates a file containing the process ID. More... | |
dbus_bool_t | _dbus_change_identity (dbus_uid_t uid, dbus_gid_t gid, DBusError *error) |
Changes the user and group the bus is running as. More... | |
void | _dbus_set_signal_handler (int sig, DBusSignalHandler handler) |
Installs a UNIX signal handler. More... | |
dbus_bool_t | _dbus_sysdeps_test (void) |
Unit test for dbus-sysdeps.c. More... | |
void | _dbus_user_database_lock_system (void) |
Locks global system user database. | |
void | _dbus_user_database_unlock_system (void) |
Unlocks global system user database. | |
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... | |
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_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_homedir_from_username (const DBusString *username, DBusString *homedir) |
Gets the home directory for the given user. More... | |
dbus_bool_t | _dbus_uid_from_string (const DBusString *uid_str, dbus_uid_t *uid) |
Gets a UID from a UID string. More... | |
dbus_bool_t | _dbus_credentials_from_username (const DBusString *username, DBusCredentials *credentials) |
Gets the credentials corresponding to the given username. More... | |
dbus_bool_t | _dbus_credentials_from_uid (dbus_uid_t uid, DBusCredentials *credentials) |
Gets the credentials corresponding to the given UID. More... | |
DBusUserDatabase * | _dbus_user_database_new (void) |
Creates a new user database object used to look up and cache user information. More... | |
DBusUserDatabase * | _dbus_user_database_ref (DBusUserDatabase *db) |
Increments refcount of user database. More... | |
void | _dbus_user_database_unref (DBusUserDatabase *db) |
Decrements refcount of user database. More... | |
dbus_bool_t | _dbus_user_database_get_groups (DBusUserDatabase *db, dbus_uid_t uid, dbus_gid_t **group_ids, int *n_group_ids, DBusError *error) |
Gets all groups for a particular user. 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_gid (DBusUserDatabase *db, dbus_gid_t gid, const DBusGroupInfo **info, DBusError *error) |
Gets the user information for the given GID, returned group 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... | |
dbus_bool_t | _dbus_user_database_get_groupname (DBusUserDatabase *db, const DBusString *groupname, const DBusGroupInfo **info, DBusError *error) |
Gets the user information for the given group name, returned group info should not be freed. 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. | |
const char | _dbus_return_if_fail_warning_format [] |
String used in _dbus_return_if_fail macro. More... |
|
Aborts with an error message if the condition is false.
Definition at line 104 of file dbus-internals.h. |
|
Aborts with an error message if called. The given explanation will be printed.
Definition at line 114 of file dbus-internals.h. |
|
Expands to declaration of a global lock defined with _DBUS_DEFINE_GLOBAL_LOCK. The lock must be added to the list to initialize in dbus_threads_init(). Definition at line 254 of file dbus-internals.h. |
|
Defines a global lock variable with the given name. The lock must be added to the list to initialize in dbus_threads_init(). Definition at line 255 of file dbus-internals.h. |
|
Safely stuffs an integer into a pointer, to be extracted later with _DBUS_POINTER_TO_INT. Only guaranteed to preserve 32 bits.
Definition at line 143 of file dbus-internals.h. |
|
Maximum length of the path to a UNIX domain socket, sockaddr_un::sun_path member. POSIX requires that all systems support at least 100 bytes here, including the nul termination. We use 99 for the max value to allow for the nul. We could probably also do sizeof (addr.sun_path) but this way we are the same on all platforms which is probably a good idea. |
|
Computes the number of elements in a fixed-size array using sizeof().
Definition at line 140 of file dbus-internals.h. |
|
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.)
Definition at line 142 of file dbus-internals.h. |
|
Sets all bits in an object to zero.
Definition at line 145 of file dbus-internals.h. |
|
Enumeration for status of a read().
Definition at line 49 of file dbus-spawn.c. |
|
Accepts a connection on a listening socket. Handles EINTR for you.
Definition at line 948 of file dbus-sysdeps.c. |
|
Atomically decrement an integer.
Definition at line 1897 of file dbus-sysdeps.c. References DBusAtomic::value. |
|
Atomically increments an integer.
Definition at line 1874 of file dbus-sysdeps.c. References DBusAtomic::value. |
|
Checks whether the child has exited, without blocking.
Definition at line 586 of file dbus-spawn.c. References DBusBabysitter::socket_to_babysitter. |
|
Blocks until the babysitter process gives us the PID of the spawned grandchild, then kills the spawned grandchild.
Definition at line 564 of file dbus-spawn.c. References DBusBabysitter::grandchild_pid. |
|
Increment the reference count on the babysitter object.
Definition at line 241 of file dbus-spawn.c. References DBusBabysitter::refcount. |
|
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).
Definition at line 608 of file dbus-spawn.c. References DBusBabysitter::errnum, DBusBabysitter::executable, DBusBabysitter::have_child_status, DBusBabysitter::have_exec_errnum, DBusBabysitter::have_fork_errnum, and DBusBabysitter::status. |
|
Sets watch functions to notify us when the babysitter object needs to read/write file descriptors.
Definition at line 666 of file dbus-spawn.c. References DBusBabysitter::watches. |
|
Decrement the reference count on the babysitter object.
Definition at line 257 of file dbus-spawn.c. References DBusBabysitter::error_pipe_from_child, DBusBabysitter::error_watch, DBusBabysitter::executable, DBusBabysitter::refcount, DBusBabysitter::sitter_pid, DBusBabysitter::sitter_watch, DBusBabysitter::socket_to_babysitter, DBusBabysitter::status, and DBusBabysitter::watches. |
|
Does the chdir, fork, setsid, etc. to become a daemon process.
Definition at line 3136 of file dbus-sysdeps.c. |
|
Changes the user and group the bus is running as.
Definition at line 3279 of file dbus-sysdeps.c. |
|
Closes a file descriptor.
Definition at line 3038 of file dbus-sysdeps.c. |
|
Appends the given filename to the given directory.
Definition at line 2455 of file dbus-sysdeps.c. |
|
Creates a socket and connects to a socket at the given host and port. The connection fd is returned, and is set up as nonblocking.
Definition at line 591 of file dbus-sysdeps.c. |
|
Creates a socket and connects it to the UNIX domain socket at the given path. The connection fd is returned, and is set up as nonblocking. Uses abstract sockets instead of filesystem-linked sockets if requested (it's possible only on Linux; see "man 7 unix" on Linux). On non-Linux abstract socket usage always fails.
Definition at line 391 of file dbus-sysdeps.c. |
|
Creates a directory; succeeds if the directory is created or already existed.
Definition at line 2393 of file dbus-sysdeps.c. |
|
Creates the given file, failing if the file already exists.
Definition at line 2320 of file dbus-sysdeps.c. |
|
Sets fields in DBusCredentials to DBUS_PID_UNSET, DBUS_UID_UNSET, DBUS_GID_UNSET.
Definition at line 1767 of file dbus-sysdeps.c. References DBusCredentials::gid, DBusCredentials::pid, and DBusCredentials::uid. |
|
Gets the credentials of the current process.
Definition at line 1780 of file dbus-sysdeps.c. References DBusCredentials::gid, DBusCredentials::pid, and DBusCredentials::uid. |
|
Gets the credentials corresponding to the given UID.
Definition at line 559 of file dbus-userdb.c. References DBusCredentials::gid, DBusCredentials::pid, DBusUserInfo::primary_gid, DBusUserInfo::uid, and DBusCredentials::uid. |
|
Gets the credentials corresponding to the given username.
Definition at line 522 of file dbus-userdb.c. References DBusCredentials::gid, DBusCredentials::pid, DBusUserInfo::primary_gid, DBusCredentials::uid, and DBusUserInfo::uid. |
|
Checks whether the provided_credentials are allowed to log in as the expected_credentials.
Definition at line 1804 of file dbus-sysdeps.c. References DBusCredentials::uid. |
|
Removes a directory; Directory must be empty.
Definition at line 2424 of file dbus-sysdeps.c. |
|
Deletes the given file.
Definition at line 2364 of file dbus-sysdeps.c. |
|
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.
Definition at line 2612 of file dbus-sysdeps.c. References DBusDirIter::d. |
|
Open a directory to iterate over.
Definition at line 2564 of file dbus-sysdeps.c. References DBusDirIter::d. |
|
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.
Definition at line 302 of file dbus-internals.c. |
|
Converts a UNIX errno into a DBusError name.
Definition at line 2839 of file dbus-sysdeps.c. |
|
Exit the process, returning the given value.
Definition at line 2933 of file dbus-sysdeps.c. |
|
Sets the file descriptor to be close on exec. Should be called for all file descriptors in D-BUS code.
Definition at line 2815 of file dbus-sysdeps.c. |
|
Appends the contents of the given file to the string, returning error code. At the moment, won't open a file more than a megabyte in size.
Definition at line 2078 of file dbus-sysdeps.c. |
|
Creates a full-duplex pipe (as in socketpair()). Sets both ends of the pipe nonblocking.
Definition at line 2988 of file dbus-sysdeps.c. |
|
Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII subset.
Definition at line 2751 of file dbus-sysdeps.c. |
|
Generates the given number of random bytes, using the best mechanism we can come up with.
Definition at line 2707 of file dbus-sysdeps.c. |
|
Get current time, as in gettimeofday().
Definition at line 2054 of file dbus-sysdeps.c. |
|
Gets group ID given groupname.
Definition at line 408 of file dbus-userdb.c. References DBusGroupInfo::gid. |
|
Gets user ID given username.
Definition at line 384 of file dbus-userdb.c. References DBusCredentials::uid. |
|
Wrapper for getenv().
Definition at line 169 of file dbus-sysdeps.c. |
|
Gets our GID.
Definition at line 1842 of file dbus-sysdeps.c. |
|
Gets our process ID.
Definition at line 1824 of file dbus-sysdeps.c. |
|
Gets our UID.
Definition at line 1833 of file dbus-sysdeps.c. |
|
Initializes the given DBusGroupInfo struct with information about the given group name.
Definition at line 1723 of file dbus-sysdeps.c. |
|
Initializes the given DBusGroupInfo struct with information about the given group ID.
Definition at line 1742 of file dbus-sysdeps.c. |
|
Frees the members of info (but not info itself).
Definition at line 1755 of file dbus-sysdeps.c. References DBusGroupInfo::groupname. |
|
Returns a string describing the given name.
Definition at line 401 of file dbus-internals.c. |
|
Gets homedir of user owning current process. The returned string is valid until dbus_shutdown() is called.
Definition at line 362 of file dbus-userdb.c. |
|
Gets the home directory for the given user.
Definition at line 443 of file dbus-userdb.c. References DBusUserInfo::homedir. |
|
Creates a socket and binds it to the given path, then listens on the socket. The socket is set to be nonblocking.
Definition at line 669 of file dbus-sysdeps.c. |
|
Creates a socket and binds it to the given path, then listens on the socket. The socket is set to be nonblocking. Uses abstract sockets instead of filesystem-linked sockets if requested (it's possible only on Linux; see "man 7 unix" on Linux). On non-Linux abstract socket usage always fails.
Definition at line 481 of file dbus-sysdeps.c. |
|
Duplicates a block of memory. Returns NULL on failure.
Definition at line 279 of file dbus-internals.c. |
|
Checks whether the filename is an absolute path.
Definition at line 2539 of file dbus-sysdeps.c. |
|
Wrapper for poll().
Definition at line 1921 of file dbus-sysdeps.c. References DBusPollFD::events, DBusPollFD::fd, and DBusPollFD::revents. |
|
On GNU libc systems, print a crude backtrace to the verbose log. On other systems, print "no backtrace support" Definition at line 3103 of file dbus-sysdeps.c. |
|
Thin wrapper around the read() system call that appends the data it reads to the DBusString buffer. It appends up to the given count, and returns the same value and same errno as read(). The only exception is that _dbus_read() handles EINTR for you. _dbus_read() can return ENOMEM, even though regular UNIX read doesn't.
Definition at line 188 of file dbus-sysdeps.c. |
|
Reads a single byte which must be nul (an error occurs otherwise), and reads unix credentials if available. Fills in pid/uid/gid with -1 if no credentials are available. Return value indicates whether a byte was read, not whether we got valid credentials. On some systems, such as Linux, reading/writing the byte isn't actually required, but we do it anyway just to avoid multiple codepaths. Fails if no byte is available, so you must select() first. The point of the byte is that on some systems we have to use sendmsg()/recvmsg() to transmit credentials.
Definition at line 790 of file dbus-sysdeps.c. References DBusCredentials::gid, DBusCredentials::pid, and DBusCredentials::uid. |
|
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.
Definition at line 446 of file dbus-internals.c. |
|
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.
Definition at line 470 of file dbus-internals.c. |
|
Sends a single nul byte with our UNIX credentials as ancillary data. Returns TRUE if the data was successfully written. On systems that don't support sending credentials, just writes a byte, doesn't send any credentials. On some systems, such as Linux, reading/writing the byte isn't actually required, but we do it anyway just to avoid multiple codepaths. Fails if no byte can be written, so you must select() first. The point of the byte is that on some systems we have to use sendmsg()/recvmsg() to transmit credentials.
Definition at line 929 of file dbus-sysdeps.c. |
|
Sets a file descriptor to be nonblocking.
Definition at line 3065 of file dbus-sysdeps.c. |
|
Installs a UNIX signal handler.
Definition at line 3311 of file dbus-sysdeps.c. |
|
Wrapper for setenv(). If the value is NULL, unsets the environment variable.
Definition at line 101 of file dbus-sysdeps.c. |
|
Sleeps the given number of milliseconds.
Definition at line 2027 of file dbus-sysdeps.c. |
|
Spawns a new process. The executable name and argv[0] are the same, both are provided in argv[0]. The child_setup function is passed the given user_data and is run in the child just before calling exec(). 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.
Definition at line 998 of file dbus-spawn.c. References DBusBabysitter::error_pipe_from_child, DBusBabysitter::error_watch, DBusBabysitter::executable, DBusBabysitter::sitter_pid, DBusBabysitter::sitter_watch, DBusBabysitter::socket_to_babysitter, and DBusBabysitter::watches. |
|
stat() wrapper.
Definition at line 2947 of file dbus-sysdeps.c. References DBusStat::atime, DBusStat::ctime, DBusStat::gid, DBusStat::mode, DBusStat::mtime, DBusStat::nlink, DBusStat::size, and DBusStat::uid. |
|
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.
Definition at line 251 of file dbus-internals.c. |
|
A wrapper around strerror() because some platforms may be lame and not have strerror().
Definition at line 2787 of file dbus-sysdeps.c. |
|
Checks whether a string array contains the given string.
Definition at line 342 of file dbus-internals.c. |
|
Get the directory name from a complete filename.
Definition at line 2491 of file dbus-sysdeps.c. |
|
Writes a string out to a file. If the file exists, it will be atomically overwritten by the new data.
Definition at line 2184 of file dbus-sysdeps.c. |
|
Unit test for dbus-sysdeps.c.
Definition at line 3375 of file dbus-sysdeps.c. |
|
Tests how well the given function responds to out-of-memory situations. Calls the function repeatedly, failing a different call to malloc() each time. If the function ever returns FALSE, the test fails. The function should return TRUE whenever something valid (such as returning an error, or succeeding) occurs, and FALSE if it gets confused in some way.
Definition at line 522 of file dbus-internals.c. |
|
Returns a string describing the given type.
Definition at line 365 of file dbus-internals.c. |
|
Gets a UID from a UID string.
Definition at line 482 of file dbus-userdb.c. |
|
Gets the user information for the given GID, returned group info should not be freed.
Definition at line 760 of file dbus-userdb.c. |
|
Gets the user information for the given group name, returned group info should not be freed.
Definition at line 799 of file dbus-userdb.c. |
|
Gets all groups for a particular user. Returns FALSE if no memory, or user isn't known, but always initializes group_ids to a NULL array. Sets error to the reason for returning FALSE.
Definition at line 692 of file dbus-userdb.c. References DBusUserInfo::group_ids, and DBusUserInfo::n_group_ids. |
|
Gets the system global user database; must be called with lock held (_dbus_user_database_lock_system()).
Definition at line 323 of file dbus-userdb.c. |
|
Gets the user information for the given UID, returned user info should not be freed.
Definition at line 740 of file dbus-userdb.c. |
|
Gets the user information for the given username.
Definition at line 779 of file dbus-userdb.c. |
|
Creates a new user database object used to look up and cache user information.
Definition at line 596 of file dbus-userdb.c. References DBusUserDatabase::groups, DBusUserDatabase::groups_by_name, DBusUserDatabase::refcount, DBusUserDatabase::users, and DBusUserDatabase::users_by_name. |
|
Increments refcount of user database.
Definition at line 641 of file dbus-userdb.c. References DBusUserDatabase::refcount. |
|
Decrements refcount of user database.
Definition at line 655 of file dbus-userdb.c. References DBusUserDatabase::groups, DBusUserDatabase::groups_by_name, DBusUserDatabase::refcount, DBusUserDatabase::users, and DBusUserDatabase::users_by_name. |
|
Gets user info for the given username.
Definition at line 1579 of file dbus-sysdeps.c. |
|
Gets user info for the given user ID.
Definition at line 1596 of file dbus-sysdeps.c. |
|
Frees the members of info (but not info itself).
Definition at line 1610 of file dbus-sysdeps.c. References DBusUserInfo::group_ids, DBusUserInfo::homedir, and DBusUserInfo::username. |
|
Gets username of user owning current process. The returned string is valid until dbus_shutdown() is called.
Definition at line 340 of file dbus-userdb.c. |
|
Prints a warning message to stderr if the user has enabled verbose mode. This is the real function implementation, use _dbus_verbose() macro in code.
Definition at line 188 of file dbus-internals.c. |
|
Prints a warning message to stderr.
Definition at line 166 of file dbus-internals.c. |
|
Thin wrapper around the write() system call that writes a part of a DBusString and handles EINTR for you.
Definition at line 248 of file dbus-sysdeps.c. |
|
Creates a file containing the process ID.
Definition at line 3223 of file dbus-sysdeps.c. |
|
Like _dbus_write() but will use writev() if possible to write both buffers in sequence. The return value is the number of bytes written in the first buffer, plus the number written in the second. If the first buffer is written successfully and an error occurs writing the second, the number of bytes in the first is returned (i.e. the error is ignored), on systems that don't have writev. Handles EINTR for you. The second buffer may be NULL.
Definition at line 294 of file dbus-sysdeps.c. |
|
Initial value: "%lu: arguments to %s() were incorrect, assertion \"%s\" failed in file %s line %d.\n" "This is normally a bug in some application using the D-BUS library.\n"
Definition at line 428 of file dbus-internals.c. |