ascii-chat
Binary v0.16.50-198-g78f51665f
Library lib/v0.3.2-2240-g78f51665f
Video chat in your terminal
Loading...
Searching...
No Matches
homedir.c File Reference

Temporary GPG homedir management implementation. More...

Go to the source code of this file.

Data Structures

struct  gpg_homedir
 Describes a temporary GnuPG home directory used to isolate key parsing from the user's real keyring. It holds the created path and cleanup bookkeeping; callers release it through the matching helper so the directory and files are removed. More...

Functions

gpg_homedir_t * gpg_homedir_create (void)
 Create a temporary GPG homedir for isolated key operations.
const char * gpg_homedir_path (const gpg_homedir_t *homedir)
 Get the homedir path for use in GPG commands.
void gpg_homedir_destroy (gpg_homedir_t *homedir)
 Destroy a temporary GPG homedir and clean up all files.

Detailed Description

Temporary GPG homedir management implementation.

Definition in file homedir.c.

Function Documentation

◆ gpg_homedir_create()

gpg_homedir_t * gpg_homedir_create ( void )

Create a temporary GPG homedir for isolated key operations.

Creates a new temporary directory configured for GPG use. The directory is isolated from the user's main GPG keyring.

Returns
Pointer to homedir handle on success, NULL on failure Caller must destroy with gpg_homedir_destroy()
Note
The directory is created in the system temp location (TMPDIR, /tmp, etc.)

Definition at line 24 of file homedir.c.

24 {
26 if (!homedir) {
27 log_error("Failed to allocate memory for GPG homedir handle");
28 return NULL;
29 }
30
31 /* Create temporary directory using platform abstraction */
32 if (platform_mkdtemp(homedir->path, sizeof(homedir->path), "ascii-chat-gpg") != 0) {
33 log_error("Failed to create temporary GPG homedir");
34 return NULL;
35 }
36
37 defer_named(temp_directory, platform_rmdir_recursive(homedir->path));
38
39 /* Restrict permissions to owner only (mode 0700) using platform abstraction */
40 if (platform_chmod(homedir->path, 0700) != 0) {
41 log_warn("Failed to set permissions on GPG homedir, attempting cleanup");
42 return NULL;
43 }
44
45 log_debug("Created temporary GPG homedir: %s", homedir->path);
46 defer_cancel(temp_directory);
47 gpg_homedir_t *result = homedir;
48 homedir = NULL;
49 return result;
50}
#define SAFE_MALLOC_DEFER_FREE(name, size, cast)
#define log_warn(...)
Log a WARN message.
Definition log/log.h:615
#define log_error(...)
Log an ERROR message.
Definition log/log.h:628
#define log_debug(...)
Log a DEBUG message.
Definition log/log.h:589
struct gpg_homedir gpg_homedir_t
Opaque handle to a temporary GPG homedir.
Definition homedir.h:45

References log_debug, log_error, log_warn, and SAFE_MALLOC_DEFER_FREE.

◆ gpg_homedir_destroy()

void gpg_homedir_destroy ( gpg_homedir_t * homedir)

Destroy a temporary GPG homedir and clean up all files.

Recursively deletes the temporary directory and all its contents. Safe to call on NULL pointer (no-op).

Parameters
homedirHandle from gpg_homedir_create() (can be NULL)

Definition at line 59 of file homedir.c.

59 {
60 if (!homedir) {
61 return;
62 }
63
64 /* Recursively delete the entire directory and all contents using platform abstraction */
65 if (platform_rmdir_recursive(homedir->path) != 0) {
66 log_warn("Failed to completely clean up GPG homedir: %s", homedir->path);
67 } else {
68 log_debug("Cleaned up temporary GPG homedir: %s", homedir->path);
69 }
70
71 SAFE_FREE(homedir);
72}
#define SAFE_FREE(ptr)
char path[4096]
Definition homedir.c:21

References log_debug, log_warn, gpg_homedir::path, and SAFE_FREE.

◆ gpg_homedir_path()

const char * gpg_homedir_path ( const gpg_homedir_t * homedir)

Get the homedir path for use in GPG commands.

Returns the filesystem path of the temporary homedir. This path should be used with gpg's –homedir flag.

Parameters
homedirHandle from gpg_homedir_create()
Returns
Pointer to path string (valid until gpg_homedir_destroy() is called) Returns NULL if homedir is invalid

Definition at line 52 of file homedir.c.

52 {
53 if (!homedir) {
54 return NULL;
55 }
56 return homedir->path;
57}

References gpg_homedir::path.