X-Git-Url: https://git.distorted.org.uk/~mdw/tripe/blobdiff_plain/6047fbac6ecdaa13a13ea71f7f62eb77b2361eec..8ed35e02a3f3d9151794e82d9b7ad68bceb04713:/common/util.h

diff --git a/common/util.h b/common/util.h
index aaef36f3..b4c45056 100644
--- a/common/util.h
+++ b/common/util.h
@@ -27,6 +27,14 @@
 #ifndef UTIL_H
 #define UTIL_H
 
+#ifndef CONFIG_H
+#  include "config.h"
+#endif
+
+#include <sys/types.h>
+
+#include <mLib/macros.h>
+
 #ifdef __cplusplus
   extern "C" {
 #endif
@@ -46,6 +54,43 @@
 
 extern void u_quotify(dstr */*d*/, const char */*p*/);
 
+/* --- @u_getuser@ --- *
+ *
+ * Arguments:	@const char *name@ = user name or id requested
+ *		@gid_t *gg@ = where to store corresponding gid
+ *
+ * Returns:	Corresponding uid.
+ *
+ * Use:		Resolves a user name into a uid.  Dies on failure; suitable
+ *		for use in argument parsing.
+ */
+
+extern uid_t u_getuser(const char */*name*/, gid_t */*gg*/);
+
+/* --- @u_getgroup@ --- *
+ *
+ * Arguments:	@const char *name@ = user name or id requested
+ *
+ * Returns:	Corresponding gid.
+ *
+ * Use:		Resolves a group name into a gid.  Dies on failure; suitable
+ *		for use in argument parsing.
+ */
+
+extern gid_t u_getgroup(const char */*name*/);
+
+/* --- @u_setugid@ --- *
+ *
+ * Arguments:	@uid_t u@ = user to set
+ *		@gid_t g@ = group to set
+ *
+ * Returns:	---
+ *
+ * Use:		Sets user and group to the given values; aborts on failure.
+ */
+
+extern void u_setugid(uid_t /*u*/, gid_t /*g*/);
+
 /*----- That's all, folks -------------------------------------------------*/
 
 #ifdef __cplusplus