DBusFile

Functions

dbus_bool_t _dbus_file_exists (const char *file)
 File interface.
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.
dbus_bool_t _dbus_string_save_to_file (const DBusString *str, const DBusString *filename, dbus_bool_t world_readable, DBusError *error)
 Writes a string out to a file.
dbus_bool_t _dbus_make_file_world_readable (const DBusString *filename, DBusError *error)
 Makes the file readable by every user in the system.
dbus_bool_t _dbus_create_file_exclusively (const DBusString *filename, DBusError *error)
 Creates the given file, failing if the file already exists.
dbus_bool_t _dbus_delete_file (const DBusString *filename, DBusError *error)
 Deletes the given file.

Function Documentation

dbus_bool_t _dbus_create_file_exclusively ( const DBusString filename,
DBusError error 
)

Creates the given file, failing if the file already exists.

Parameters:
filename the filename
error error location
Returns:
TRUE if we created the file and it didn't exist

Definition at line 353 of file dbus-file-unix.c.

References _dbus_close(), _dbus_string_get_const_data(), DBUS_ERROR_FAILED, dbus_set_error(), FALSE, and NULL.

dbus_bool_t _dbus_delete_file ( const DBusString filename,
DBusError error 
)

Deletes the given file.

Parameters:
filename the filename
error error location
Returns:
TRUE if unlink() succeeded

Definition at line 399 of file dbus-file-unix.c.

References _dbus_strerror_from_errno(), _dbus_string_get_const_data(), DBUS_ERROR_FAILED, dbus_set_error(), and FALSE.

dbus_bool_t _dbus_file_exists ( const char *  file  ) 

File interface.

File interface.

Parameters:
file full path to the file
Returns:
TRUE if file exists

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

Referenced by _dbus_user_at_console().

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.

At the moment, won't open a file more than a megabyte in size.

Parameters:
str the string to append to
filename filename to load
error place to set an error
Returns:
FALSE if error was set

Definition at line 55 of file dbus-file-unix.c.

References _dbus_close(), _dbus_error_from_errno(), _dbus_read(), _dbus_string_get_const_data(), _dbus_string_get_length(), _dbus_string_set_length(), DBUS_ERROR_FAILED, dbus_set_error(), FALSE, and NULL.

dbus_bool_t _dbus_make_file_world_readable ( const DBusString filename,
DBusError error 
)

Makes the file readable by every user in the system.

Parameters:
filename the filename
error error location
Returns:
TRUE if the file's permissions could be changed.

Definition at line 326 of file dbus-file-unix.c.

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

Referenced by _dbus_string_save_to_file().

dbus_bool_t _dbus_string_save_to_file ( const DBusString str,
const DBusString filename,
dbus_bool_t  world_readable,
DBusError error 
)

Writes a string out to a file.

If the file exists, it will be atomically overwritten by the new data.

Parameters:
str the string to write out
filename the file to save string to
world_readable If set, ensure the file is world readable
error error to be filled in on failure
Returns:
FALSE on failure

If the file exists, it will be atomically overwritten by the new data.

Parameters:
str the string to write out
filename the file to save string to
world_readable if true, ensure file is world readable
error error to be filled in on failure
Returns:
FALSE on failure

Definition at line 164 of file dbus-file-unix.c.

References _dbus_close(), _dbus_error_from_errno(), _dbus_generate_random_ascii(), _dbus_make_file_world_readable(), _dbus_string_append(), _dbus_string_copy(), _dbus_string_free(), _dbus_string_get_const_data(), _dbus_string_get_length(), _dbus_string_init(), _dbus_write(), DBUS_ERROR_NO_MEMORY, dbus_set_error(), FALSE, and NULL.

Generated on Tue Sep 28 00:25:05 2010 for D-Bus by  doxygen 1.6.3