X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/tripe/blobdiff_plain/53a941d3f97a50964587c6e9533b1e43e74a57a8..8d513103f66617e96234d19813ab655ed9d5d13d:/common/util.h

diff --git a/common/util.h b/common/util.h
index b76e1259..b844945f 100644
--- a/common/util.h
+++ b/common/util.h
@@ -9,24 +9,31 @@
  *
  * This file is part of Trivial IP Encryption (TrIPE).
  *
- * TrIPE is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
+ * TrIPE is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License as published by the Free
+ * Software Foundation; either version 3 of the License, or (at your
+ * option) any later version.
  *
- * TrIPE is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
+ * TrIPE is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with TrIPE; if not, write to the Free Software Foundation,
- * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * along with TrIPE.  If not, see <https://www.gnu.org/licenses/>.
  */
 
 #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,28 +53,42 @@
 
 extern void u_quotify(dstr */*d*/, const char */*p*/);
 
-/* --- @u_detach@ --- *
+/* --- @u_getuser@ --- *
  *
- * Arguments:	---
+ * Arguments:	@const char *name@ = user name or id requested
+ *		@gid_t *gg@ = where to store corresponding gid
  *
- * Returns:	---
+ * 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@ --- *
  *
- * Use:		Detaches from the current terminal and ensures it can never
- *		acquire a new one.  Calls @fork@.
+ * 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 void u_detach(void);
+extern gid_t u_getgroup(const char */*name*/);
 
-/* --- @u_daemon@ --- *
+/* --- @u_setugid@ --- *
  *
- * Arguments:	---
+ * Arguments:	@uid_t u@ = user to set
+ *		@gid_t g@ = group to set
  *
- * Returns:	Zero if OK, nonzero on failure.
+ * Returns:	---
  *
- * Use:		Becomes a daemon.
+ * Use:		Sets user and group to the given values; aborts on failure.
  */
 
-extern int u_daemon(void);
+extern void u_setugid(uid_t /*u*/, gid_t /*g*/);
 
 /*----- That's all, folks -------------------------------------------------*/