lib/set-acl.c

   1 /* set-acl.c - set access control list equivalent to a mode
   2
   3    Copyright (C) 2002-2003, 2005-2024 Free Software Foundation, Inc.
   4
   5    This program is free software: you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation, either version 3 of the License, or
   8    (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17
  18    Written by Paul Eggert and Andreas Gruenbacher, and Bruno Haible.  */
  19
  20 #include <config.h>
  21
  22 #include "acl.h"
  23
  24 #include <errno.h>
  25
  26 #include "quote.h"
  27 #include <error.h>
  28 #include "gettext.h"
  29 #define _(msgid) gettext (msgid)
  30
  31 /* Set the access control lists of a file to match *exactly* MODE (this might
  32    remove inherited ACLs). Note chmod() tends to honor inherited/default
  33    ACLs. If DESC is a valid file descriptor, use file descriptor operations
  34    where available, else use filename based operations on NAME.  If access
  35    control lists are not available, fchmod the target file to MODE.  Also
  36    sets the non-permission bits of the destination file
  37    (S_ISUID, S_ISGID, S_ISVTX) to those from MODE if any are set.
  38     Return 0 if successful.  On failure, output a diagnostic, set errno and
  39     return -1.  */
  40
  41 int
  42 set_acl (char const *name, int desc, mode_t mode)
  43 {
  44   int ret = qset_acl (name, desc, mode);
  45   if (ret != 0)
  46     error (0, errno, _("setting permissions for %s"), quote (name));
  47   return ret;
  48 }