xref: /aosp_15_r20/external/toybox/toys/posix/chmod.c (revision cf5a6c84e2b8763fc1a7db14496fd4742913b199)

/* chmod.c - Change file mode bits
 *
 * Copyright 2012 Rob Landley <[email protected]>
 *
 * See http://opengroup.org/onlinepubs/9699919799/utilities/chmod.html

USE_CHMOD(NEWTOY(chmod, "<2?vfR[-vf]", TOYFLAG_BIN))

config CHMOD
  bool "chmod"
  default y
  help
    usage: chmod [-R] MODE FILE...

    Change mode of listed file[s] (recursively with -R).

    MODE can be (comma-separated) stanzas: [ugoa][+-=][rwxstXugo]

    Stanzas are applied in order: For each category (u = user,
    g = group, o = other, a = all three, if none specified default is a),
    set (+), clear (-), or copy (=), r = read, w = write, x = execute.
    s = u+s = suid, g+s = sgid, +t = sticky. (o+s ignored so a+s doesn't set +t)
    suid/sgid: execute as the user/group who owns the file.
    sticky: can't delete files you don't own out of this directory
    X = x for directories or if any category already has x set.

    Or MODE can be an octal value up to 7777	ug uuugggooo	top +
    bit 1 = o+x, bit 1<<8 = u+w, 1<<11 = g+1	sstrwxrwxrwx	bottom

    Examples:
    chmod u+w file - allow owner of "file" to write to it.
    chmod 744 file - user can read/write/execute, everyone else read only
*/

#define FOR_chmod
#include "toys.h"

GLOBALS(
  char *mode;
)

static int do_chmod(struct dirtree *try)
{
  mode_t mode;

  if (!dirtree_notdotdot(try)) return 0;

  if (FLAG(R) && try->parent && S_ISLNK(try->st.st_mode)) {
    // Ignore symlinks found during recursion. We'll only try to modify
    // symlinks mentioned directly as arguments. We'll fail, of course,
    // but that's what you asked for in that case.
  } else {
    mode = string_to_mode(TT.mode, try->st.st_mode) & ~S_IFMT;
    if (FLAG(v)) {
      char *s = dirtree_path(try, 0);

      printf("chmod '%s' to %s\n", s, TT.mode);
      free(s);
    }
    wfchmodat(dirtree_parentfd(try), try->name, mode);
  }

  return FLAG(R)*DIRTREE_RECURSE;
}

void chmod_main(void)
{
  TT.mode = *toys.optargs;
  char **file;

  for (file = toys.optargs+1; *file; file++) dirtree_read(*file, do_chmod);
}