1  /* set-acl.c - set access control list equivalent to a mode
       2  
       3     Copyright (C) 2002-2003, 2005-2023 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  }