;;; GNU Guix --- Functional package management for GNU
;;; Copyright © 2021 Brice Waegeneire <brice@waegenei.re>
;;;
;;; This file is part of GNU Guix.
;;;
;;; GNU Guix 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.
;;;
;;; GNU Guix 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 GNU Guix.  If not, see <http://www.gnu.org/licenses/>.

(define-module (gnu system setuid)
  #:use-module (guix records)
  #:export (setuid-program
            setuid-program?
            setuid-program-program
            setuid-program-setuid?
            setuid-program-setgid?
            setuid-program-user
            setuid-program-group

            file-like->setuid-program))

;;; Commentary:
;;;
;;; Data structures representing setuid/setgid programs.  This is meant to be
;;; used both on the host side and at run time--e.g., in activation snippets.
;;;
;;; Code:

(define-record-type* <setuid-program>
  setuid-program make-setuid-program
  setuid-program?
  ;; Path to program to link with setuid permissions
  (program       setuid-program-program) ;file-like
  ;; Whether to set user setuid bit
  (setuid?       setuid-program-setuid? ;boolean
                 (default #t))
  ;; Whether to set group setgid bit
  (setgid?       setuid-program-setgid? ;boolean
                 (default #f))
  ;; The user this should be set to (defaults to root)
  (user          setuid-program-user    ;integer or string
                 (default 0))
  ;; Group we want to set this to (defaults to root)
  (group         setuid-program-group   ;integer or string
                 (default 0)))

(define (file-like->setuid-program program)
  (setuid-program (program program)))
log/doc?id=16babde41e4ca5e4da31e22312018288c2d89060'>doc</a>/<a href='/guix/log/doc/htmlxref.cnf?id=16babde41e4ca5e4da31e22312018288c2d89060'>htmlxref.cnf</a></div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/guix/log/doc/htmlxref.cnf?id=16babde41e4ca5e4da31e22312018288c2d89060&amp;showmsg=1'>Expand</a>)</th><th class='left'>Author</th></tr>
<tr><td><span title='2024-06-03 00:27:12 +0200'>2024-06-03</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=834a4195241806784d4b321b95f06d85f458ce18'>nls: Update translations.</a><span class='msg-avail'>...</span></td><td>Florian Pelz</td></tr>
<tr><td><span title='2024-04-01 14:09:20 +0200'>2024-04-01</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=fa98837b1d9586b9ca7bf77dae22c3bde0fc59b5'>nls: Update translations.</a><span class='msg-avail'>...</span></td><td>Florian Pelz</td></tr>
<tr><td><span title='2022-12-18 16:01:32 +0100'>2022-12-18</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=8e2f32cee982d42a79e53fc1e9aa7b8ff0514714'>doc: Update URLs for the manual and cookbook translations.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2022-12-18 15:53:43 +0100'>2022-12-18</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=b77b4c7c3a5ac180f5aed0983be50ffbe6832f87'>doc: Add guile-netlink to 'htmlxref.cnf'.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2022-08-05 00:14:29 +0200'>2022-08-05</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=f9a267c6d266355b48bd12288f4414eaf4db8b33'>doc: Fix Guix manual URLs in 'htmlxref.cnf'.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2022-06-16 21:52:49 -0400'>2022-06-16</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=ec7a75034421654d2ece2ba20033b44d345547f0'>doc: Remove obsolete comment from htmlxref.cnf.</a><span class='msg-avail'>...</span></td><td>Maxim Cournoyer</td></tr>
<tr><td><span title='2022-04-08 19:59:25 +0200'>2022-04-08</span></td><td><a href='/guix/commit/doc/htmlxref.cnf?id=868da34d54365023223a4ff7520043ba55ad64e8'>doc: Fix cookbook URLs in htmlxref.cnf.</a><span class='msg-avail'>...</span></td><td>Ludovic Courtès</td></tr>