src/basic/user-util.h

	user-util.h revision b26fa1a2fbcfee7d03b0c8fd15ec3aa64ae70b9f
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore#pragma once
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore/***
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  This file is part of systemd.
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  Copyright 2010 Lennart Poettering
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  systemd is free software; you can redistribute it and/or modify it
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  under the terms of the GNU Lesser General Public License as published by
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  the Free Software Foundation; either version 2.1 of the License, or
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  (at your option) any later version.
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  systemd is distributed in the hope that it will be useful, but
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  WITHOUT ANY WARRANTY; without even the implied warranty of
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  Lesser General Public License for more details.
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  You should have received a copy of the GNU Lesser General Public License
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore  along with systemd; If not, see <http://www.gnu.org/licenses/>.
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore***/
538aa54d819fa7751ca82bcc30d4ed8c57ec2ef2Garrett D'Amore
#include <stdbool.h>
#include <sys/types.h>

bool uid_is_valid(uid_t uid);

static inline bool gid_is_valid(gid_t gid) {
        return uid_is_valid((uid_t) gid);
}

int parse_uid(const char *s, uid_t* ret_uid);

static inline int parse_gid(const char *s, gid_t *ret_gid) {
        return parse_uid(s, (uid_t*) ret_gid);
}

char* getlogname_malloc(void);
char* getusername_malloc(void);

int get_user_creds(const char **username, uid_t *uid, gid_t *gid, const char **home, const char **shell);
int get_group_creds(const char **groupname, gid_t *gid);

char* uid_to_name(uid_t uid);
char* gid_to_name(gid_t gid);

int in_gid(gid_t gid);
int in_group(const char *name);

int get_home_dir(char **ret);
int get_shell(char **_ret);

int reset_uid_gid(void);

int take_etc_passwd_lock(const char *root);

#define UID_INVALID ((uid_t) -1)
#define GID_INVALID ((gid_t) -1)

/* The following macros add 1 when converting things, since UID 0 is a
 * valid UID, while the pointer NULL is special */
#define PTR_TO_UID(p) ((uid_t) (((uintptr_t) (p))-1))
#define UID_TO_PTR(u) ((void*) (((uintptr_t) (u))+1))

#define PTR_TO_GID(p) ((gid_t) (((uintptr_t) (p))-1))
#define GID_TO_PTR(u) ((void*) (((uintptr_t) (u))+1))