| /* SPDX-License-Identifier: LGPL-2.1-or-later */ |
| #pragma once |
| |
| #include <sys/socket.h> |
| #include <sys/un.h> |
| |
| #include "group-record.h" |
| #include "user-record.h" |
| |
| /* Inquire local services for user/group records */ |
| |
| typedef struct UserDBIterator UserDBIterator; |
| |
| UserDBIterator *userdb_iterator_free(UserDBIterator *iterator); |
| DEFINE_TRIVIAL_CLEANUP_FUNC(UserDBIterator*, userdb_iterator_free); |
| |
| typedef enum UserDBFlags { |
| /* The main sources */ |
| USERDB_EXCLUDE_NSS = 1 << 0, /* don't do client-side nor server-side NSS */ |
| USERDB_EXCLUDE_VARLINK = 1 << 1, /* don't talk to any varlink services */ |
| USERDB_EXCLUDE_DROPIN = 1 << 2, /* don't load drop-in user/group definitions */ |
| |
| /* Modifications */ |
| USERDB_SUPPRESS_SHADOW = 1 << 3, /* don't do client-side shadow calls (server side might happen though) */ |
| USERDB_EXCLUDE_DYNAMIC_USER = 1 << 4, /* exclude looking up in io.systemd.DynamicUser */ |
| USERDB_AVOID_MULTIPLEXER = 1 << 5, /* exclude looking up via io.systemd.Multiplexer */ |
| USERDB_DONT_SYNTHESIZE = 1 << 6, /* don't synthesize root/nobody */ |
| |
| /* Combinations */ |
| USERDB_NSS_ONLY = USERDB_EXCLUDE_VARLINK|USERDB_EXCLUDE_DROPIN|USERDB_DONT_SYNTHESIZE, |
| USERDB_DROPIN_ONLY = USERDB_EXCLUDE_NSS|USERDB_EXCLUDE_VARLINK|USERDB_DONT_SYNTHESIZE, |
| } UserDBFlags; |
| |
| /* Well-known errors we'll return here: |
| * |
| * -ESRCH: No such user/group |
| * -ELINK: Varlink logic turned off (and no other source available) |
| * -EOPNOTSUPP: Enumeration not supported |
| * -ETIMEDOUT: Time-out |
| */ |
| |
| int userdb_by_name(const char *name, UserDBFlags flags, UserRecord **ret); |
| int userdb_by_uid(uid_t uid, UserDBFlags flags, UserRecord **ret); |
| int userdb_all(UserDBFlags flags, UserDBIterator **ret); |
| int userdb_iterator_get(UserDBIterator *iterator, UserRecord **ret); |
| |
| int groupdb_by_name(const char *name, UserDBFlags flags, GroupRecord **ret); |
| int groupdb_by_gid(gid_t gid, UserDBFlags flags, GroupRecord **ret); |
| int groupdb_all(UserDBFlags flags, UserDBIterator **ret); |
| int groupdb_iterator_get(UserDBIterator *iterator, GroupRecord **ret); |
| |
| int membershipdb_by_user(const char *name, UserDBFlags flags, UserDBIterator **ret); |
| int membershipdb_by_group(const char *name, UserDBFlags flags, UserDBIterator **ret); |
| int membershipdb_all(UserDBFlags flags, UserDBIterator **ret); |
| int membershipdb_iterator_get(UserDBIterator *iterator, char **user, char **group); |
| int membershipdb_by_group_strv(const char *name, UserDBFlags flags, char ***ret); |
| |
| int userdb_block_nss_systemd(int b); |