1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 #pragma once
3 
4 typedef struct DynamicUser DynamicUser;
5 
6 typedef struct DynamicCreds {
7         /* A combination of a dynamic user and group */
8         DynamicUser *user;
9         DynamicUser *group;
10 } DynamicCreds;
11 
12 #include "manager.h"
13 
14 /* Note that this object always allocates a pair of user and group under the same name, even if one of them isn't
15  * used. This means, if you want to allocate a group and user pair, and they might have two different names, then you
16  * need to allocated two of these objects. DynamicCreds below makes that easy. */
17 struct DynamicUser {
18         Manager *manager;
19         unsigned n_ref;
20 
21         /* An AF_UNIX socket pair that contains a datagram containing both the numeric ID assigned, as well as a lock
22          * file fd locking the user ID we picked. */
23         int storage_socket[2];
24 
25         char name[];
26 };
27 
28 int dynamic_user_serialize(Manager *m, FILE *f, FDSet *fds);
29 void dynamic_user_deserialize_one(Manager *m, const char *value, FDSet *fds);
30 void dynamic_user_vacuum(Manager *m, bool close_user);
31 
32 int dynamic_user_current(DynamicUser *d, uid_t *ret);
33 int dynamic_user_lookup_uid(Manager *m, uid_t uid, char **ret);
34 int dynamic_user_lookup_name(Manager *m, const char *name, uid_t *ret);
35 
36 int dynamic_creds_acquire(DynamicCreds *creds, Manager *m, const char *user, const char *group);
37 int dynamic_creds_realize(DynamicCreds *creds, char **suggested_paths, uid_t *uid, gid_t *gid);
38 
39 void dynamic_creds_unref(DynamicCreds *creds);
40 void dynamic_creds_destroy(DynamicCreds *creds);
41