diff options
Diffstat (limited to 'file_cmds/chown')
-rw-r--r-- | file_cmds/chown/chgrp.1 | 144 | ||||
-rw-r--r-- | file_cmds/chown/chown.8 | 177 | ||||
-rw-r--r-- | file_cmds/chown/chown.c | 345 |
3 files changed, 666 insertions, 0 deletions
diff --git a/file_cmds/chown/chgrp.1 b/file_cmds/chown/chgrp.1 new file mode 100644 index 0000000..593c609 --- /dev/null +++ b/file_cmds/chown/chgrp.1 @@ -0,0 +1,144 @@ +.\" Copyright (c) 1983, 1990, 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" This code is derived from software contributed to Berkeley by +.\" the Institute of Electrical and Electronics Engineers, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)chgrp.1 8.3 (Berkeley) 3/31/94 +.\" $FreeBSD: src/usr.sbin/chown/chgrp.1,v 1.13 2001/08/15 09:09:46 ru Exp $ +.\" +.Dd March 31, 1994 +.Dt CHGRP 1 +.Os +.Sh NAME +.Nm chgrp +.Nd change group +.Sh SYNOPSIS +.Nm chgrp +.Op Fl fhnv +.Oo +.Fl R +.Op Fl H | Fl L | Fl P +.Oc +.Ar group +.Ar +.Sh DESCRIPTION +The +.Nm chgrp +utility sets the group ID of the file named by each +.Ar file +operand to the +.Ar group +ID specified by the group operand. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl f +The force option ignores errors, except for usage errors and doesn't +query about strange modes (unless the user does not have proper permissions). +.It Fl H +If the +.Fl R +option is specified, symbolic links on the command line are followed. +(Symbolic links encountered in the tree traversal are not followed). +.It Fl h +If the file is a symbolic link, the group ID of the link itself is changed +rather than the file that is pointed to. +.It Fl L +If the +.Fl R +option is specified, all symbolic links are followed. +.It Fl P +If the +.Fl R +option is specified, no symbolic links are followed. +This is the default. Use +.Fl h +to change the group ID of a symbolic link. +.It Fl R +Change the group ID for the file hierarchies rooted +in the files instead of just the files themselves. +.It Fl n +Interpret the group ID as numeric, avoiding the name lookup. +.It Fl v +Cause +.Nm chgrp +to be verbose, showing files as the group is modified. +.El +.Pp +The +.Fl H , +.Fl L +and +.Fl P +options are ignored unless the +.Fl R +option is specified. +In addition, these options override each other and the +command's actions are determined by the last one specified. +.Pp +The +.Ar group +operand can be either a group name from the group database, +or a numeric group ID. +If a group name is also a numeric group ID, the operand is used as a +group name. +.Pp +The user invoking +.Nm chgrp +must belong to the specified group and be the owner of the file, +or be the super-user. +.Sh DIAGNOSTICS +.Ex -std +.Sh COMPATIBILITY +In previous versions of this system, symbolic links did not have groups. +.Pp +The +.Fl v +option is non-standard and its use in scripts is not recommended. +.Sh FILES +.Bl -tag -width /etc/group -compact +.It Pa /etc/group +group ID file +.El +.Sh SEE ALSO +.Xr chown 2 , +.Xr fts 3 , +.Xr group 5 , +.Xr passwd 5 , +.Xr symlink 7 , +.Xr chown 8 +.Sh STANDARDS +The +.Nm chgrp +utility is expected to be +.St -p1003.2 +compatible. diff --git a/file_cmds/chown/chown.8 b/file_cmds/chown/chown.8 new file mode 100644 index 0000000..3455497 --- /dev/null +++ b/file_cmds/chown/chown.8 @@ -0,0 +1,177 @@ +.\" Copyright (c) 1990, 1991, 1993, 1994 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)chown.8 8.3 (Berkeley) 3/31/94 +.\" $FreeBSD: src/usr.sbin/chown/chown.8,v 1.20 2002/07/14 14:42:43 charnier Exp $ +.\" +.Dd March 31, 1994 +.Dt CHOWN 8 +.Os +.Sh NAME +.Nm chown +.Nd change file owner and group +.Sh SYNOPSIS +.Nm chown +.Op Fl fhnv +.Oo +.Fl R +.Op Fl H | Fl L | Fl P +.Oc +.Ar owner Ns Op : Ns Ar group +.Ar +.Nm chown +.Op Fl fhnv +.Oo +.Fl R +.Op Fl H | Fl L | Fl P +.Oc +.No : Ns Ar group +.Ar +.Sh DESCRIPTION +The +.Nm chown +utility changes the user ID and/or the group ID of the specified files. +Symbolic links named by arguments are silently left unchanged unless +.Fl h +is used. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl f +Don't report any failure to change file owner or group, nor modify +the exit status to reflect such failures. +.It Fl H +If the +.Fl R +option is specified, symbolic links on the command line are followed. +(Symbolic links encountered in the tree traversal are not followed.) +.It Fl h +If the file is a symbolic link, change the user ID and/or the +group ID of the link itself. +.It Fl L +If the +.Fl R +option is specified, all symbolic links are followed. +.It Fl P +If the +.Fl R +option is specified, no symbolic links are followed. +Instead, the user and/or group ID of the link itself are modified. +This is the default. Use +.Fl h +to change the user ID and/or the group of symbolic links. +.It Fl R +Change the user ID and/or the group ID for the file hierarchies rooted +in the files instead of just the files themselves. +.It Fl n +Interpret user ID and group ID as numeric, avoiding name lookups. +.It Fl v +Cause +.Nm chown +to be verbose, showing files as the owner is modified. +.El +.Pp +The +.Fl H , +.Fl L +and +.Fl P +options are ignored unless the +.Fl R +option is specified. +In addition, these options override each other and the +command's actions are determined by the last one specified. +.Pp +The +.Ar owner +and +.Ar group +operands are both optional; +however, at least one must be specified. +If the +.Ar group +operand is specified, it must be preceded by a colon (``:'') character. +.Pp +The +.Ar owner +may be either a numeric user ID or a user name. +If a user name is also a numeric user ID, the operand is used as a +user name. +The +.Ar group +may be either a numeric group ID or a group name. +If a group name is also a numeric group ID, the operand is used as a +group name. +.Pp +For obvious security reasons, +the ownership of a file may only be altered by a super-user. +Similarly, only a member of a group can change a file's group ID +to that group. +.Sh DIAGNOSTICS +.Ex -std +.Sh COMPATIBILITY +Previous versions of the +.Nm chown +utility used the dot (``.'') character to distinguish the group name. +This has been changed to be a colon (``:'') character, +so that user and group names may contain the dot character. +.Pp +On previous versions of this system, +symbolic links did not have owners. +.Pp +The +.Fl v +option is non-standard and its use in scripts is not recommended. +.Sh LEGACY DESCRIPTION +In legacy mode, the +.Fl R +and +.Fl RP +options do not change the user ID +or the group ID of symbolic links. +.Sh SEE ALSO +.Xr chgrp 1 , +.Xr find 1 , +.Xr chown 2 , +.Xr fts 3 , +.Xr compat 5 , +.Xr symlink 7 +.Sh STANDARDS +The +.Nm chown +utility is expected to be +.St -p1003.2 +compliant. +.Sh HISTORY +A +.Nm chown +utility appeared in +.At v1 . diff --git a/file_cmds/chown/chown.c b/file_cmds/chown/chown.c new file mode 100644 index 0000000..708a6c5 --- /dev/null +++ b/file_cmds/chown/chown.c @@ -0,0 +1,345 @@ +/* + * Copyright (c) 1988, 1993, 1994 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#include <sys/cdefs.h> +#ifndef lint +__used static const char copyright[] = +"@(#) Copyright (c) 1988, 1993, 1994\n\ + The Regents of the University of California. All rights reserved.\n"; +#endif /* not lint */ + +#ifndef lint +#if 0 +static char sccsid[] = "@(#)chown.c 8.8 (Berkeley) 4/4/94"; +#endif +#endif /* not lint */ + +#include <sys/cdefs.h> +__RCSID("$FreeBSD: src/usr.sbin/chown/chown.c,v 1.24 2002/07/17 16:22:24 dwmalone Exp $"); + +#include <sys/param.h> +#include <sys/stat.h> + +#include <err.h> +#include <errno.h> +#include <fts.h> +#include <grp.h> +#include <pwd.h> +#include <stdio.h> +#include <stdlib.h> +#include <string.h> +#include <unistd.h> +#include <sys/time.h> + +#ifdef __APPLE__ +#include <get_compat.h> +#else +#define COMPAT_MODE(a,b) (1) +#endif /* __APPLE__ */ + +void a_gid(const char *); +void a_uid(const char *); +void chownerr(const char *); +static uid_t id(const char *, const char *); +void usage(void); + +uid_t uid; +gid_t gid; +int ischown; +#ifdef __APPLE__ +int isnumeric = 0; +#endif +const char *gname; + +int +main(int argc, char **argv) +{ + FTS *ftsp; + FTSENT *p; + int Hflag, Lflag, Pflag, Rflag, fflag, hflag, vflag; + int ch, fts_options, rval; + char *cp; + int unix2003_compat = 0; + int symlink_found = 0; + + if (argc < 1) + usage(); + cp = strrchr(argv[0], '/'); + cp = (cp != NULL) ? cp + 1 : argv[0]; + ischown = (strcmp(cp, "chown") == 0); + + Hflag = Lflag = Pflag = Rflag = fflag = hflag = vflag = 0; +#ifdef __APPLE__ + while ((ch = getopt(argc, argv, "HLPRfhnv")) != -1) +#else + while ((ch = getopt(argc, argv, "HLPRfhv")) != -1) +#endif + switch (ch) { + case 'H': + Hflag = 1; + Lflag = Pflag = 0; + break; + case 'L': + Lflag = 1; + Hflag = Pflag = 0; + break; + case 'P': + Pflag = 1; + Hflag = Lflag = 0; + break; + case 'R': + Rflag = 1; + break; + case 'f': + fflag = 1; + break; + case 'h': + hflag = 1; + break; +#ifdef __APPLE__ + case 'n': + isnumeric = 1; + break; +#endif + case 'v': + vflag = 1; + break; + case '?': + default: + usage(); + } + argv += optind; + argc -= optind; + + if (argc < 2) + usage(); + if (!Rflag && (Hflag || Lflag || Pflag)) + warnx("options -H, -L, -P only useful with -R"); + + if (Rflag) { + fts_options = FTS_PHYSICAL; + if (hflag && (Hflag || Lflag)) + errx(1, "the -R%c and -h options may not be " + "specified together", Hflag ? 'H' : 'L'); + if (Hflag) + fts_options |= FTS_COMFOLLOW; + else if (Lflag) { + fts_options &= ~FTS_PHYSICAL; + fts_options |= FTS_LOGICAL; + } + } else + fts_options = hflag ? FTS_PHYSICAL : FTS_LOGICAL; + + uid = (uid_t)-1; + gid = (gid_t)-1; + if (ischown) { + unix2003_compat = COMPAT_MODE("bin/chown", "Unix2003"); + if ((cp = strchr(*argv, ':')) != NULL) { + *cp++ = '\0'; + a_gid(cp); + } +#ifdef SUPPORT_DOT + else if ((cp = strchr(*argv, '.')) != NULL) { + warnx("separation of user and group with a period is deprecated"); + *cp++ = '\0'; + a_gid(cp); + } +#endif + a_uid(*argv); + } else { + unix2003_compat = COMPAT_MODE("bin/chgrp", "Unix2003"); + a_gid(*argv); + } + + if ((ftsp = fts_open(++argv, fts_options, 0)) == NULL) + err(1, NULL); + + for (rval = 0; (p = fts_read(ftsp)) != NULL;) { + symlink_found = 0; + switch (p->fts_info) { + case FTS_D: /* Change it at FTS_DP. */ + if (!Rflag) + fts_set(ftsp, p, FTS_SKIP); + continue; + case FTS_DNR: /* Warn, chown. */ + warnx("%s: %s", p->fts_path, strerror(p->fts_errno)); + rval = 1; + break; + case FTS_ERR: /* Warn, continue. */ + case FTS_NS: + warnx("%s: %s", p->fts_path, strerror(p->fts_errno)); + rval = 1; + continue; + case FTS_SL: + case FTS_SLNONE: + /* + * The only symlinks that end up here are ones that + * don't point to anything and ones that we found + * doing a physical walk. + */ + if (hflag) + break; + else { + symlink_found = 1; + if (unix2003_compat) { + if (Hflag || Lflag) { /* -H or -L was specified */ + if (p->fts_errno) { + warnx("%s: %s", p->fts_name, strerror(p->fts_errno)); + rval = 1; + continue; + } + } + break; /* Otherwise symlinks keep going */ + } + continue; + } + default: + break; + } + if (unix2003_compat) { + /* Can only avoid updating times if both uid and gid are -1 */ + if ((uid == (uid_t)-1) && (gid == (gid_t)-1)) + continue; + } else { + if ((uid == (uid_t)-1 || uid == p->fts_statp->st_uid) && + (gid == (gid_t)-1 || gid == p->fts_statp->st_gid)) + continue; + } + if (((hflag || symlink_found) ? lchown : chown)(p->fts_accpath, uid, gid) == -1) { + if (!fflag) { + chownerr(p->fts_path); + rval = 1; + } + } else { + if (vflag) + printf("%s\n", p->fts_path); + } + } + if (errno) + err(1, "fts_read"); + exit(rval); +} + +void +a_gid(const char *s) +{ + struct group *gr; + + if (*s == '\0') /* Argument was "uid[:.]". */ + return; + gname = s; +#ifdef __APPLE__ + gid = (!isnumeric && ((gr = getgrnam(s)) != NULL)) ? gr->gr_gid : id(s, "group"); +#else + gid = ((gr = getgrnam(s)) != NULL) ? gr->gr_gid : id(s, "group"); +#endif +} + +void +a_uid(const char *s) +{ + struct passwd *pw; + + if (*s == '\0') /* Argument was "[:.]gid". */ + return; +#ifdef __APPLE__ + uid = (!isnumeric && ((pw = getpwnam(s)) != NULL)) ? pw->pw_uid : id(s, "user"); +#else + uid = ((pw = getpwnam(s)) != NULL) ? pw->pw_uid : id(s, "user"); +#endif +} + +static uid_t +id(const char *name, const char *type) +{ + unsigned long val; + char *ep; + + errno = 0; + val = strtoul(name, &ep, 10); + if (errno || *ep != '\0' || val > UID_MAX) + errx(1, "%s: illegal %s name", name, type); + return (uid_t)val; +} + +void +chownerr(const char *file) +{ + static uid_t euid = -1; + static int ngroups = -1; + gid_t groups[NGROUPS_MAX]; + + /* Check for chown without being root. */ + if (errno != EPERM || (uid != (uid_t)-1 && + euid == (uid_t)-1 && (euid = geteuid()) != 0)) { + warn("%s", file); + return; + } + + /* Check group membership; kernel just returns EPERM. */ + if (gid != (gid_t)-1 && ngroups == -1 && + euid == (uid_t)-1 && (euid = geteuid()) != 0) { + ngroups = getgroups(NGROUPS_MAX, groups); + while (--ngroups >= 0 && gid != groups[ngroups]); + if (ngroups < 0) { + warnx("you are not a member of group %s", gname); + return; + } + } + warn("%s", file); +} + +void +usage(void) +{ + + if (ischown) + (void)fprintf(stderr, "%s\n%s\n", +#ifdef __APPLE__ + "usage: chown [-fhnv] [-R [-H | -L | -P]] owner[:group]" + " file ...", + " chown [-fhnv] [-R [-H | -L | -P]] :group file ..."); +#else + "usage: chown [-fhv] [-R [-H | -L | -P]] owner[:group]" + " file ...", + " chown [-fhv] [-R [-H | -L | -P]] :group file ..."); +#endif + else + (void)fprintf(stderr, "%s\n", +#ifdef __APPLE__ + "usage: chgrp [-fhnv] [-R [-H | -L | -P]] group file ..."); +#else + "usage: chgrp [-fhv] [-R [-H | -L | -P]] group file ..."); +#endif + exit(1); +} |