1 /* chgrp -- change group ownership of files
2 Copyright (C) 89, 90, 91, 1995-2005 Free Software Foundation, Inc.
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2, or (at your option)
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software Foundation,
16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1307, USA. */
18 /* Written by David MacKenzie <djm@gnu.ai.mit.edu>. */
22 #include <sys/types.h>
27 #include "chown-core.h"
30 #include "group-member.h"
35 /* The official name of this program (e.g., no `g' prefix). */
36 #define PROGRAM_NAME "chgrp"
38 #define AUTHORS "David MacKenzie", "Jim Meyering"
40 #ifndef _POSIX_VERSION
41 struct group *getgrnam ();
45 # define endgrent() ((void) 0)
48 /* The name the program was run with. */
51 /* The argument to the --reference option. Use the group ID of this file.
52 This file must exist. */
53 static char *reference_file;
55 /* For long options that have no equivalent short option, use a
56 non-character as a pseudo short option, starting with CHAR_MAX + 1. */
59 DEREFERENCE_OPTION = CHAR_MAX + 1,
63 static struct option const long_options[] =
65 {"recursive", no_argument, NULL, 'R'},
66 {"changes", no_argument, NULL, 'c'},
67 {"dereference", no_argument, NULL, DEREFERENCE_OPTION},
68 {"no-dereference", no_argument, NULL, 'h'},
69 {"quiet", no_argument, NULL, 'f'},
70 {"silent", no_argument, NULL, 'f'},
71 {"reference", required_argument, NULL, REFERENCE_FILE_OPTION},
72 {"verbose", no_argument, NULL, 'v'},
73 {GETOPT_HELP_OPTION_DECL},
74 {GETOPT_VERSION_OPTION_DECL},
78 /* Return the group ID of NAME, or -1 if no name was specified. */
81 parse_group (const char *name)
87 struct group *grp = getgrnam (name);
92 unsigned long int tmp;
93 if (! (xstrtoul (name, NULL, 10, &tmp, "") == LONGINT_OK
95 error (EXIT_FAILURE, 0, _("invalid group %s"), quote (name));
98 endgrent (); /* Save a file descriptor. */
107 if (status != EXIT_SUCCESS)
108 fprintf (stderr, _("Try `%s --help' for more information.\n"),
113 Usage: %s [OPTION]... GROUP FILE...\n\
114 or: %s [OPTION]... --reference=RFILE FILE...\n\
116 program_name, program_name);
118 Change the group of each FILE to GROUP.\n\
119 With --reference, change the group of each FILE to that of RFILE.\n\
121 -c, --changes like verbose but report only when a change is made\n\
122 --dereference affect the referent of each symbolic link, rather\n\
123 than the symbolic link itself (this is the default)\n\
126 -h, --no-dereference affect each symbolic link instead of any referenced\n\
127 file (useful only on systems that can change the\n\
128 ownership of a symlink)\n\
131 --no-preserve-root do not treat `/' specially (the default)\n\
132 --preserve-root fail to operate recursively on `/'\n\
135 -f, --silent, --quiet suppress most error messages\n\
136 --reference=RFILE use RFILE's group rather than the specifying\n\
138 -R, --recursive operate on files and directories recursively\n\
139 -v, --verbose output a diagnostic for every file processed\n\
143 The following options modify how a hierarchy is traversed when the -R\n\
144 option is also specified. If more than one is specified, only the final\n\
147 -H if a command line argument is a symbolic link\n\
148 to a directory, traverse it\n\
149 -L traverse every symbolic link to a directory\n\
151 -P do not traverse any symbolic links (default)\n\
154 fputs (HELP_OPTION_DESCRIPTION, stdout);
155 fputs (VERSION_OPTION_DESCRIPTION, stdout);
159 %s staff /u Change the group of /u to \"staff\".\n\
160 %s -hR staff /u Change the group of /u and subfiles to \"staff\".\n\
162 program_name, program_name);
163 printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
169 main (int argc, char **argv)
173 /* Bit flags that control how fts works. */
174 int bit_flags = FTS_PHYSICAL;
176 /* 1 if --dereference, 0 if --no-dereference, -1 if neither has been
178 int dereference = -1;
180 struct Chown_option chopt;
184 initialize_main (&argc, &argv);
185 program_name = argv[0];
186 setlocale (LC_ALL, "");
187 bindtextdomain (PACKAGE, LOCALEDIR);
188 textdomain (PACKAGE);
190 atexit (close_stdout);
194 while ((optc = getopt_long (argc, argv, "HLPRcfhv", long_options, NULL))
199 case 'H': /* Traverse command-line symlinks-to-directories. */
200 bit_flags = FTS_COMFOLLOW | FTS_PHYSICAL;
203 case 'L': /* Traverse all symlinks-to-directories. */
204 bit_flags = FTS_LOGICAL;
207 case 'P': /* Traverse no symlinks-to-directories. */
208 bit_flags = FTS_PHYSICAL;
211 case 'h': /* --no-dereference: affect symlinks */
215 case DEREFERENCE_OPTION: /* --dereference: affect the referent
220 case REFERENCE_FILE_OPTION:
221 reference_file = optarg;
225 chopt.recurse = true;
229 chopt.verbosity = V_changes_only;
233 chopt.force_silent = true;
237 chopt.verbosity = V_high;
240 case_GETOPT_HELP_CHAR;
241 case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS);
243 usage (EXIT_FAILURE);
249 if (bit_flags == FTS_PHYSICAL)
251 if (dereference == 1)
252 error (EXIT_FAILURE, 0,
253 _("-R --dereference requires either -H or -L"));
254 chopt.affect_symlink_referent = false;
258 if (dereference == 0)
259 error (EXIT_FAILURE, 0, _("-R -h requires -P"));
260 chopt.affect_symlink_referent = true;
265 bit_flags = FTS_PHYSICAL;
266 chopt.affect_symlink_referent = (dereference != 0);
269 if (argc - optind < (reference_file ? 1 : 2))
272 error (0, 0, _("missing operand"));
274 error (0, 0, _("missing operand after %s"), quote (argv[argc - 1]));
275 usage (EXIT_FAILURE);
280 struct stat ref_stats;
281 if (stat (reference_file, &ref_stats))
282 error (EXIT_FAILURE, errno, _("failed to get attributes of %s"),
283 quote (reference_file));
285 gid = ref_stats.st_gid;
286 chopt.group_name = gid_to_name (ref_stats.st_gid);
290 char *group_name = argv[optind++];
291 chopt.group_name = (*group_name ? group_name : NULL);
292 gid = parse_group (group_name);
295 ok = chown_files (argv + optind, bit_flags,
297 (uid_t) -1, (gid_t) -1, &chopt);
301 exit (ok ? EXIT_SUCCESS : EXIT_FAILURE);