config: more tweaking of help texts
[oweals/busybox.git] / miscutils / makedevs.c
index 2c9a0a9af9103c40f96a6da294444e282d6fc4aa..c2f86df01f19856e8abb15f6f1989cf3485d89bd 100644 (file)
@@ -1,17 +1,4 @@
 /* vi: set sw=4 ts=4: */
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <fcntl.h>
-#include <getopt.h>
-#include <time.h>
-#include <unistd.h>
-#include <sys/types.h>
-#include <sys/sysmacros.h>     /* major() and minor() */
-#include "busybox.h"
-
-#ifdef CONFIG_FEATURE_MAKEDEVS_LEAF
 /*
  * public domain -- Dave 'Kill a Cop' Cinege <dcinege@psychosis.com>
  *
  * Make ranges of device files quickly.
  * known bugs: can't deal with alpha ranges
  */
+//config:config MAKEDEVS
+//config:      bool "makedevs (9.3 kb)"
+//config:      default y
+//config:      help
+//config:      'makedevs' is a utility used to create a batch of devices with
+//config:      one command.
+//config:
+//config:      There are two choices for command line behaviour, the interface
+//config:      as used by LEAF/Linux Router Project, or a device table file.
+//config:
+//config:      'leaf' is traditionally what busybox follows, it allows multiple
+//config:      devices of a particluar type to be created per command.
+//config:      e.g. /dev/hda[0-9]
+//config:      Device properties are passed as command line arguments.
+//config:
+//config:      'table' reads device properties from a file or stdin, allowing
+//config:      a batch of unrelated devices to be made with one command.
+//config:      User/group names are allowed as an alternative to uid/gid.
+//config:
+//config:choice
+//config:      prompt "Choose makedevs behaviour"
+//config:      depends on MAKEDEVS
+//config:      default FEATURE_MAKEDEVS_TABLE
+//config:
+//config:config FEATURE_MAKEDEVS_LEAF
+//config:      bool "leaf"
+//config:
+//config:config FEATURE_MAKEDEVS_TABLE
+//config:      bool "table"
+//config:
+//config:endchoice
+
+//applet:IF_MAKEDEVS(APPLET(makedevs, BB_DIR_SBIN, BB_SUID_DROP))
+
+//kbuild:lib-$(CONFIG_MAKEDEVS) += makedevs.o
+
+//usage:#if ENABLE_FEATURE_MAKEDEVS_LEAF
+//usage:#define makedevs_trivial_usage
+//usage:       "NAME TYPE MAJOR MINOR FIRST LAST [s]"
+//usage:#define makedevs_full_usage "\n\n"
+//usage:       "Create a range of block or character special files"
+//usage:     "\n"
+//usage:     "\nTYPE is:"
+//usage:     "\n       b       Block device"
+//usage:     "\n       c       Character device"
+//usage:     "\n       f       FIFO, MAJOR and MINOR are ignored"
+//usage:     "\n"
+//usage:     "\nFIRST..LAST specify numbers appended to NAME."
+//usage:     "\nIf 's' is the last argument, the base device is created as well."
+//usage:     "\n"
+//usage:     "\nExamples:"
+//usage:     "\n       makedevs /dev/ttyS c 4 66 2 63   ->  ttyS2-ttyS63"
+//usage:     "\n       makedevs /dev/hda b 3 0 0 8 s    ->  hda,hda1-hda8"
+//usage:
+//usage:#define makedevs_example_usage
+//usage:       "# makedevs /dev/ttyS c 4 66 2 63\n"
+//usage:       "[creates ttyS2-ttyS63]\n"
+//usage:       "# makedevs /dev/hda b 3 0 0 8 s\n"
+//usage:       "[creates hda,hda1-hda8]\n"
+//usage:#endif
+//usage:
+//usage:#if ENABLE_FEATURE_MAKEDEVS_TABLE
+//usage:#define makedevs_trivial_usage
+//usage:       "[-d device_table] rootdir"
+//usage:#define makedevs_full_usage "\n\n"
+//usage:       "Create a range of special files as specified in a device table.\n"
+//usage:       "Device table entries take the form of:\n"
+//usage:       "<name> <type> <mode> <uid> <gid> <major> <minor> <start> <inc> <count>\n"
+//usage:       "Where name is the file name, type can be one of:\n"
+//usage:       "       f       Regular file\n"
+//usage:       "       d       Directory\n"
+//usage:       "       c       Character device\n"
+//usage:       "       b       Block device\n"
+//usage:       "       p       Fifo (named pipe)\n"
+//usage:       "uid is the user id for the target file, gid is the group id for the\n"
+//usage:       "target file. The rest of the entries (major, minor, etc) apply to\n"
+//usage:       "to device special files. A '-' may be used for blank entries."
+//usage:
+//usage:#define makedevs_example_usage
+//usage:       "For example:\n"
+//usage:       "<name>    <type> <mode><uid><gid><major><minor><start><inc><count>\n"
+//usage:       "/dev         d   755    0    0    -      -      -      -    -\n"
+//usage:       "/dev/console c   666    0    0    5      1      -      -    -\n"
+//usage:       "/dev/null    c   666    0    0    1      3      0      0    -\n"
+//usage:       "/dev/zero    c   666    0    0    1      5      0      0    -\n"
+//usage:       "/dev/hda     b   640    0    0    3      0      0      0    -\n"
+//usage:       "/dev/hda     b   640    0    0    3      1      1      1    15\n\n"
+//usage:       "Will Produce:\n"
+//usage:       "/dev\n"
+//usage:       "/dev/console\n"
+//usage:       "/dev/null\n"
+//usage:       "/dev/zero\n"
+//usage:       "/dev/hda\n"
+//usage:       "/dev/hda[0-15]\n"
+//usage:#endif
+
+#include "libbb.h"
+
+#if ENABLE_FEATURE_MAKEDEVS_LEAF
+/*
+makedevs NAME TYPE MAJOR MINOR FIRST LAST [s]
+TYPEs:
+b       Block device
+c       Character device
+f       FIFO
+
+FIRST..LAST specify numbers appended to NAME.
+If 's' is the last argument, the base device is created as well.
+Examples:
+        makedevs /dev/ttyS c 4 66 2 63   ->  ttyS2-ttyS63
+        makedevs /dev/hda b 3 0 0 8 s    ->  hda,hda1-hda8
+*/
+int makedevs_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 int makedevs_main(int argc, char **argv)
 {
        mode_t mode;
-       char *basedev, *type, *nodname, buf[255];
+       char *basedev, *type, *nodname, *buf;
        int Smajor, Sminor, S, E;
 
-       if (argc < 7 || *argv[1]=='-')
+       if (argc < 7 || argv[1][0] == '-')
                bb_show_usage();
 
        basedev = argv[1];
+       buf = xasprintf("%s%u", argv[1], (unsigned)-1);
        type = argv[2];
-       Smajor = atoi(argv[3]);
-       Sminor = atoi(argv[4]);
-       S = atoi(argv[5]);
-       E = atoi(argv[6]);
-       nodname = argc == 8 ? basedev : buf;
+       Smajor = xatoi_positive(argv[3]);
+       Sminor = xatoi_positive(argv[4]);
+       S = xatoi_positive(argv[5]);
+       E = xatoi_positive(argv[6]);
+       nodname = argv[7] ? basedev : buf;
 
        mode = 0660;
-
        switch (type[0]) {
        case 'c':
                mode |= S_IFCHR;
@@ -53,18 +153,17 @@ int makedevs_main(int argc, char **argv)
        }
 
        while (S <= E) {
-               int sz;
+               sprintf(buf, "%s%u", basedev, S);
 
-               sz = snprintf(buf, sizeof(buf), "%s%d", basedev, S);
-               if(sz<0 || sz>=sizeof(buf))  /* libc different */
-                       bb_error_msg_and_die("%s too large", basedev);
-
-       /* if mode != S_IFCHR and != S_IFBLK third param in mknod() ignored */
-
-               if (mknod(nodname, mode, makedev(Smajor, Sminor)))
-                       bb_error_msg("Failed to create: %s", nodname);
+               /* if mode != S_IFCHR and != S_IFBLK,
+                * third param in mknod() ignored */
+               if (mknod(nodname, mode, makedev(Smajor, Sminor)) != 0
+                && errno != EEXIST
+               ) {
+                       bb_perror_msg("can't create '%s'", nodname);
+               }
 
-               if (nodname == basedev) /* ex. /dev/hda - to /dev/hda1 ... */
+               /*if (nodname == basedev)*/ /* ex. /dev/hda - to /dev/hda1 ... */
                        nodname = buf;
                S++;
                Sminor++;
@@ -73,153 +172,141 @@ int makedevs_main(int argc, char **argv)
        return 0;
 }
 
-#elif defined CONFIG_FEATURE_MAKEDEVS_TABLE
+#elif ENABLE_FEATURE_MAKEDEVS_TABLE
 
-/*
- *  This program is free software; you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License version 2 as
- *  published by the Free Software Foundation.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU Library General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program; if not, write to the Free Software
- *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
- *
- */
-
-static const struct option makedevs_long_options[] = {
-       {"root", 1, NULL, 'r'},
-       {0, 0, 0, 0}
-};
+/* Licensed under GPLv2 or later, see file LICENSE in this source tree. */
 
-extern int makedevs_main(int argc, char **argv)
+int makedevs_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
+int makedevs_main(int argc UNUSED_PARAM, char **argv)
 {
-       FILE *table;
-       int opt;
-       char *rootdir = "./";
-       char *line;
+       parser_t *parser;
+       char *line = (char *)"-";
        int ret = EXIT_SUCCESS;
 
-       bb_opt_complementaly = "d~r";
-       bb_applet_long_options = makedevs_long_options;
-       opt = bb_getopt_ulflags(argc, argv, "d:r:", &rootdir, &rootdir);
+       opt_complementary = "=1"; /* exactly one param */
+       getopt32(argv, "d:", &line);
+       argv += optind;
 
-       if (optind + 1 == argc) {
-               table = bb_xfopen(argv[optind], "r");
-       } else {
-               table = stdin;
-       }
-
-       if (chdir(rootdir) == -1) {
-               bb_perror_msg_and_die("Couldnt chdor to %s", rootdir);
-       }
+       xchdir(*argv); /* ensure root dir exists */
 
        umask(0);
 
-       while ((line = bb_get_chomped_line_from_file(table))) {
+       printf("rootdir=%s\ntable=", *argv);
+       if (NOT_LONE_DASH(line)) {
+               printf("'%s'\n", line);
+       } else {
+               puts("<stdin>");
+       }
+
+       parser = config_open(line);
+       while (config_read(parser, &line, 1, 1, "# \t", PARSE_NORMAL)) {
+               int linenum;
                char type;
-               unsigned int mode = 0755;
-               unsigned int major = 0;
-               unsigned int minor = 0;
-               unsigned int count = 0;
-               unsigned int increment = 0;
-               unsigned int start = 0;
-               char name[41];
+               unsigned mode = 0755;
+               unsigned major = 0;
+               unsigned minor = 0;
+               unsigned count = 0;
+               unsigned increment = 0;
+               unsigned start = 0;
                char user[41];
                char group[41];
                char *full_name;
+               int name_len;
                uid_t uid;
                gid_t gid;
 
-               if ((2 > sscanf(line, "%40s %c %o %40s %40s %u %u %u %u %u", name,
-                       &type, &mode, user, group, &major,
-                       &minor, &start, &increment, &count)) ||
-                       ((major | minor | start | count | increment) > 255)) {
-                       bb_error_msg("Ignoring invalid line\n%s\n", line);
+               linenum = parser->lineno;
+
+               if ((1 > sscanf(line, "%*s%n %c %o %40s %40s %u %u %u %u %u",
+                                       &name_len, &type, &mode, user, group,
+                                       &major, &minor, &start, &increment, &count))
+                || ((unsigned)(major | minor | start | count | increment) > 255)
+               ) {
+                       bb_error_msg("invalid line %d: '%s'", linenum, line);
                        ret = EXIT_FAILURE;
                        continue;
                }
-               if (name[0] == '#') {
-                       continue;
-               }
-               if (group) {
-                       gid = get_ug_id(group, my_getgrnam);
-               } else {
-                       gid = getgid();
-               }
-               if (user) {
-                       uid = get_ug_id(user, my_getpwnam);
-               } else {
-                       uid = getuid();
-               }
-               full_name = concat_path_file(rootdir, name);
+
+               gid = (*group) ? get_ug_id(group, xgroup2gid) : getgid();
+               uid = (*user) ? get_ug_id(user, xuname2uid) : getuid();
+               line[name_len] = '\0';
+               full_name = line;
+               /* We are already in the right root dir,
+                * so make absolute paths relative */
+               if ('/' == full_name[0])
+                       full_name++;
 
                if (type == 'd') {
-                       bb_make_directory(full_name, mode | S_IFDIR, 0);
+                       bb_make_directory(full_name, mode | S_IFDIR, FILEUTILS_RECUR);
                        if (chown(full_name, uid, gid) == -1) {
-                               bb_perror_msg("chown failed for %s", full_name);
+ chown_fail:
+                               bb_perror_msg("line %d: can't chown %s", linenum, full_name);
+                               ret = EXIT_FAILURE;
+                               continue;
+                       }
+                       if (chmod(full_name, mode) < 0) {
+ chmod_fail:
+                               bb_perror_msg("line %d: can't chmod %s", linenum, full_name);
+                               ret = EXIT_FAILURE;
+                               continue;
+                       }
+               } else if (type == 'f') {
+                       struct stat st;
+                       if ((stat(full_name, &st) < 0 || !S_ISREG(st.st_mode))) {
+                               bb_perror_msg("line %d: regular file '%s' does not exist", linenum, full_name);
                                ret = EXIT_FAILURE;
-                               goto loop;
+                               continue;
                        }
+                       if (chown(full_name, uid, gid) < 0)
+                               goto chown_fail;
+                       if (chmod(full_name, mode) < 0)
+                               goto chmod_fail;
                } else {
-                       dev_t rdev;
+                       unsigned i;
 
                        if (type == 'p') {
                                mode |= S_IFIFO;
-                       }
-                       else if (type == 'c') {
+                       } else if (type == 'c') {
                                mode |= S_IFCHR;
-                       }
-                       else if (type == 'b') {
+                       } else if (type == 'b') {
                                mode |= S_IFBLK;
                        } else {
-                               bb_error_msg("Unsupported file type %c", type);
+                               bb_error_msg("line %d: unsupported file type %c", linenum, type);
                                ret = EXIT_FAILURE;
-                               goto loop;
+                               continue;
                        }
 
-                       if (count > 0) {
-                               int i;
-                               char *full_name_inc;
-
-                               full_name_inc = xmalloc(strlen(full_name) + 4);
-                               for (i = start; i < count; i++) {
-                                       sprintf(full_name_inc, "%s%d", full_name, i);
-                                       rdev = (major << 8) + minor + (i * increment - start);
-                                       if (mknod(full_name_inc, mode, rdev) == -1) {
-                                               bb_perror_msg("Couldnt create node %s", full_name_inc);
-                                               ret = EXIT_FAILURE;
-                                       }
-                                       else if (chown(full_name_inc, uid, gid) == -1) {
-                                               bb_perror_msg("chown failed for %s", full_name_inc);
-                                               ret = EXIT_FAILURE;
-                                       }
-                               }
-                               free(full_name_inc);
-                       } else {
-                               rdev = (major << 8) + minor;
-                               if (mknod(full_name, mode, rdev) == -1) {
-                                       bb_perror_msg("Couldnt create node %s", full_name);
+                       if (count != 0)
+                               count--;
+                       for (i = 0; i <= count; i++) {
+                               dev_t rdev;
+                               char *nameN = full_name;
+                               if (count != 0)
+                                       nameN = xasprintf("%s%u", full_name, start + i);
+                               rdev = makedev(major, minor + i * increment);
+                               if (mknod(nameN, mode, rdev) != 0
+                                && errno != EEXIST
+                               ) {
+                                       bb_perror_msg("line %d: can't create node %s", linenum, nameN);
                                        ret = EXIT_FAILURE;
-                               }
-                               else if (chown(full_name, uid, gid) == -1) {
-                                       bb_perror_msg("chown failed for %s", full_name);
+                               } else if (chown(nameN, uid, gid) < 0) {
+                                       bb_perror_msg("line %d: can't chown %s", linenum, nameN);
+                                       ret = EXIT_FAILURE;
+                               } else if (chmod(nameN, mode) < 0) {
+                                       bb_perror_msg("line %d: can't chmod %s", linenum, nameN);
                                        ret = EXIT_FAILURE;
                                }
+                               if (count != 0)
+                                       free(nameN);
                        }
                }
-loop:
-               free(line);
-               free(full_name);
        }
-       fclose(table);
+       if (ENABLE_FEATURE_CLEAN_UP)
+               config_close(parser);
 
-       return 0;
+       return ret;
 }
+
 #else
-# error makdedevs configuration error, either leaf or table must be selected
+# error makedevs configuration error, either leaf or table must be selected
 #endif