1  /* qset-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  #define ACL_INTERNAL_INLINE _GL_EXTERN_INLINE
      23  
      24  #include <string.h>
      25  #include "acl.h"
      26  
      27  #include "acl-internal.h"
      28  
      29  /* Set the access control lists of a file to match *exactly* MODE (this might
      30     remove inherited ACLs). Note chmod() tends to honor inherited/default
      31     ACLs. If DESC is a valid file descriptor, use file descriptor operations
      32     where available, else use filename based operations on NAME.  If access
      33     control lists are not available, fchmod the target file to MODE.  Also
      34     sets the non-permission bits of the destination file
      35     (S_ISUID, S_ISGID, S_ISVTX) to those from MODE if any are set.
      36     Return 0 if successful.  Return -1 and set errno upon failure.  */
      37  
      38  int
      39  qset_acl (char const *name, int desc, mode_t mode)
      40  {
      41    struct permission_context ctx;
      42    int ret;
      43  
      44    memset (&ctx, 0, sizeof ctx);
      45    ctx.mode = mode;
      46    ret = set_permissions (&ctx, name, desc);
      47    free_permission_context (&ctx);
      48    return ret;
      49  }