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
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * TrIPE is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with TrIPE; if not, write to the Free Software Foundation,
24 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
34 #include <sys/types.h>
40 /*----- Macros ------------------------------------------------------------*/
44 * Arguments: @expr@ = an expression whose value is to be ignored
46 * Use: Ignores the value of an expression, even if compilers want
50 #define IGNORE(expr) do { if (expr) ; } while (0)
52 /*----- Functions provided ------------------------------------------------*/
54 /* --- @u_quotify@ --- *
56 * Arguments: @dstr *d@ = where to write the answer
57 * @const char *p@ = string to quotify
61 * Use: Quotes the given string if necessary, according to our
65 extern void u_quotify(dstr */
*d*/
, const char */
*p*/
);
67 /* --- @u_getuser@ --- *
69 * Arguments: @const char *name@ = user name or id requested
70 * @gid_t *gg@ = where to store corresponding gid
72 * Returns: Corresponding uid.
74 * Use: Resolves a user name into a uid. Dies on failure; suitable
75 * for use in argument parsing.
78 extern uid_t
u_getuser(const char */
*name*/
, gid_t */
*gg*/
);
80 /* --- @u_getgroup@ --- *
82 * Arguments: @const char *name@ = user name or id requested
84 * Returns: Corresponding gid.
86 * Use: Resolves a group name into a gid. Dies on failure; suitable
87 * for use in argument parsing.
90 extern gid_t
u_getgroup(const char */
*name*/
);
92 /* --- @u_setugid@ --- *
94 * Arguments: @uid_t u@ = user to set
95 * @gid_t g@ = group to set
99 * Use: Sets user and group to the given values; aborts on failure.
102 extern void u_setugid(uid_t
/*u*/, gid_t
/*g*/);
104 /*----- That's all, folks -------------------------------------------------*/