3 * Utilities for the client and the server
5 * (c) 2001 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of Trivial IP Encryption (TrIPE).
12 * TrIPE is free software: you can redistribute it and/or modify it under
13 * the terms of the GNU General Public License as published by the Free
14 * Software Foundation; either version 3 of the License, or (at your
15 * option) any later version.
17 * TrIPE is distributed in the hope that it will be useful, but WITHOUT
18 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22 * You should have received a copy of the GNU General Public License
23 * along with TrIPE. If not, see <https://www.gnu.org/licenses/>.
33 #include <sys/types.h>
35 #include <mLib/macros.h>
41 /*----- Functions provided ------------------------------------------------*/
43 /* --- @u_quotify@ --- *
45 * Arguments: @dstr *d@ = where to write the answer
46 * @const char *p@ = string to quotify
50 * Use: Quotes the given string if necessary, according to our
54 extern void u_quotify(dstr */
*d*/
, const char */
*p*/
);
56 /* --- @u_getuser@ --- *
58 * Arguments: @const char *name@ = user name or id requested
59 * @gid_t *gg@ = where to store corresponding gid
61 * Returns: Corresponding uid.
63 * Use: Resolves a user name into a uid. Dies on failure; suitable
64 * for use in argument parsing.
67 extern uid_t
u_getuser(const char */
*name*/
, gid_t */
*gg*/
);
69 /* --- @u_getgroup@ --- *
71 * Arguments: @const char *name@ = user name or id requested
73 * Returns: Corresponding gid.
75 * Use: Resolves a group name into a gid. Dies on failure; suitable
76 * for use in argument parsing.
79 extern gid_t
u_getgroup(const char */
*name*/
);
81 /* --- @u_setugid@ --- *
83 * Arguments: @uid_t u@ = user to set
84 * @gid_t g@ = group to set
88 * Use: Sets user and group to the given values; aborts on failure.
91 extern void u_setugid(uid_t
/*u*/, gid_t
/*g*/);
93 /*----- That's all, folks -------------------------------------------------*/