From 5fd83771641d15c418f747bd343ba6738d3875f7 Mon Sep 17 00:00:00 2001 From: Cameron Katri Date: Sun, 9 May 2021 14:20:58 -0400 Subject: Import macOS userland adv_cmds-176 basic_cmds-55 bootstrap_cmds-116.100.1 developer_cmds-66 diskdev_cmds-667.40.1 doc_cmds-53.60.1 file_cmds-321.40.3 mail_cmds-35 misc_cmds-34 network_cmds-606.40.1 patch_cmds-17 remote_cmds-63 shell_cmds-216.60.1 system_cmds-880.60.2 text_cmds-106 --- shell_cmds/apply/apply.1 | 140 +++++++++++++++++++++++++ shell_cmds/apply/apply.c | 267 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 407 insertions(+) create mode 100644 shell_cmds/apply/apply.1 create mode 100644 shell_cmds/apply/apply.c (limited to 'shell_cmds/apply') diff --git a/shell_cmds/apply/apply.1 b/shell_cmds/apply/apply.1 new file mode 100644 index 0000000..2eb1516 --- /dev/null +++ b/shell_cmds/apply/apply.1 @@ -0,0 +1,140 @@ +.\" Copyright (c) 1983, 1990, 1993 +.\" 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. +.\" +.\" @(#)apply.1 8.2 (Berkeley) 4/4/94 +.\" $FreeBSD: src/usr.bin/apply/apply.1,v 1.14 2002/04/19 23:16:06 charnier Exp $ +.\" +.Dd April 4, 1994 +.Dt APPLY 1 +.Os +.Sh NAME +.Nm apply +.Nd apply a command to a set of arguments +.Sh SYNOPSIS +.Nm +.Op Fl a Ar c +.Op Fl d +.Op Fl # +.Ar command argument ... +.Sh DESCRIPTION +The +.Nm +utility runs the named +.Ar command +on each +argument +.Ar argument +in turn. +.Pp +Character sequences of the form +.Dq Li \&%d +in +.Ar command , +where +.Sq Li d +is a digit from 1 to 9, are replaced by the +.Li d Ns \'th +following unused +.Ar argument . +In this case, the largest digit number of arguments are discarded for +each execution of +.Ar command . +.Pp +The options are as follows: +.Bl -tag -width indent +.It Fl # +Normally arguments are taken singly; the optional number +.Fl # +specifies the number of arguments to be passed to +.Ar command . +If the number is zero, +.Ar command +is run, without arguments, once for each +.Ar argument . +.Pp +If any sequences of +.Dq Li \&%d +occur in +.Ar command , +the +.Fl # +option is ignored. +.It Fl a Ar c +The use of the character +.Sq Li % +as a magic character may be changed with the +.Fl a +option. +.It Fl d +Display the commands that would have been executed, but do not actually +execute them. +.El +.Sh ENVIRONMENT +The following environment variable affects the execution of +.Nm : +.Bl -tag -width SHELL +.It Ev SHELL +Pathname of shell to use. +If this variable is not defined, the Bourne shell is used. +.El +.Sh EXAMPLES +.Bl -tag -width apply -compact +.It Li "apply echo a*" +is similar to +.Xr ls 1 ; +.It Li "apply \-2 cmp a1 b1 a2 b2 a3 b3" +compares the `a' files to the `b' files; +.It Li "apply \-0 who 1 2 3 4 5" +runs +.Xr who 1 +5 times; and +.It Li "apply \'ln %1 /usr/joe\'" * +links all files in the current directory to the directory +.Pa /usr/joe . +.El +.Sh FILES +.Bl -tag -width /bin/sh -compact +.It Pa /bin/sh +default shell +.El +.Sh AUTHORS +.An Rob Pike +.Sh BUGS +Shell metacharacters in +.Ar command +may have bizarre effects; it is best to enclose complicated +commands in single quotes +.Pq '' . +.Sh HISTORY +The +.Nm +command appeared in +.Bx 4.2 . diff --git a/shell_cmds/apply/apply.c b/shell_cmds/apply/apply.c new file mode 100644 index 0000000..cf4e9c1 --- /dev/null +++ b/shell_cmds/apply/apply.c @@ -0,0 +1,267 @@ +/*- + * Copyright (c) 1994 + * The Regents of the University of California. All rights reserved. + * + * This code is derived from software contributed to Berkeley by + * Jan-Simon Pendry. + * + * 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. + */ + +#if 0 +#ifndef lint +static char sccsid[] = "@(#)apply.c 8.4 (Berkeley) 4/4/94"; +#endif +#endif + +#include +__RCSID("$FreeBSD: src/usr.bin/apply/apply.c,v 1.22 2002/07/14 18:22:12 alfred Exp $"); + +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +#define EXEC "exec " + +static int exec_shell(const char *, char *, char *); +static void usage(void); + +int +main(int argc, char *argv[]) { + int ch, debug, i, magic, n, nargs, offset, rval; + size_t clen, cmdsize, l; + char *c, *cmd, *name, *p, *q, *shell, *slashp, *tmpshell; + + debug = 0; + magic = '%'; /* Default magic char is `%'. */ + nargs = -1; + while ((ch = getopt(argc, argv, "a:d0123456789")) != -1) + switch (ch) { + case 'a': + if (optarg[1] != '\0') + errx(1, + "illegal magic character specification"); + magic = optarg[0]; + break; + case 'd': + debug = 1; + break; + case '0': case '1': case '2': case '3': case '4': + case '5': case '6': case '7': case '8': case '9': + if (nargs != -1) + errx(1, + "only one -# argument may be specified"); + nargs = optopt - '0'; + break; + default: + usage(); + } + argc -= optind; + argv += optind; + + if (argc < 2) + usage(); + + /* + * The command to run is argv[0], and the args are argv[1..]. + * Look for %digit references in the command, remembering the + * largest one. + */ + for (n = 0, p = argv[0]; *p != '\0'; ++p) + if (p[0] == magic && isdigit(p[1]) && p[1] != '0') { + ++p; + if (p[0] - '0' > n) + n = p[0] - '0'; + } + + /* + * Figure out the shell and name arguments to pass to execl() + * in exec_shell(). Always malloc() shell and just set name + * to point at the last part of shell if there are any backslashes, + * otherwise just set it to point at the space malloc()'d. If + * SHELL environment variable exists, replace contents of + * shell with it. + */ + shell = name = NULL; + tmpshell = getenv("SHELL"); + shell = (tmpshell != NULL) ? strdup(tmpshell) : strdup(_PATH_BSHELL); + if (shell == NULL) + err(1, "strdup() failed"); + slashp = strrchr(shell, '/'); + name = (slashp != NULL) ? slashp + 1 : shell; + + /* + * If there were any %digit references, then use those, otherwise + * build a new command string with sufficient %digit references at + * the end to consume (nargs) arguments each time round the loop. + * Allocate enough space to hold the maximum command. Save the + * size to pass to snprintf(). + */ + cmdsize = sizeof(EXEC) - 1 + strlen(argv[0]) + + 9 * (sizeof(" %1") - 1) + 1; + if ((cmd = malloc(cmdsize)) == NULL) + err(1, NULL); + + if (n == 0) { + /* If nargs not set, default to a single argument. */ + if (nargs == -1) + nargs = 1; + + p = cmd; + offset = snprintf(cmd, cmdsize, EXEC "%s", argv[0]); + if ((size_t)offset >= cmdsize) + err(1, "snprintf() failed"); + p += offset; + cmdsize -= offset; + for (i = 1; i <= nargs; i++) { + offset = snprintf(p, cmdsize, " %c%d", magic, i); + if ((size_t)offset >= cmdsize) + err(1, "snprintf() failed"); + p += offset; + cmdsize -= offset; + } + + /* + * If nargs set to the special value 0, eat a single + * argument for each command execution. + */ + if (nargs == 0) + nargs = 1; + } else { + offset = snprintf(cmd, cmdsize, EXEC "%s", argv[0]); + if ((size_t)offset >= cmdsize) + err(1, "snprintf() failed"); + nargs = n; + } + + /* + * Grab some space in which to build the command. Allocate + * as necessary later, but no reason to build it up slowly + * for the normal case. + */ + if ((c = malloc(clen = 1024)) == NULL) + err(1, NULL); + + /* + * (argc) and (argv) are still offset by one to make it simpler to + * expand %digit references. At the end of the loop check for (argc) + * equals 1 means that all the (argv) has been consumed. + */ + for (rval = 0; argc > nargs; argc -= nargs, argv += nargs) { + /* + * Find a max value for the command length, and ensure + * there's enough space to build it. + */ + for (l = strlen(cmd), i = 0; i < nargs; i++) + l += strlen(argv[i+1]); + if (l > clen && (c = realloc(c, clen = l)) == NULL) + err(1, NULL); + + /* Expand command argv references. */ + for (p = cmd, q = c; *p != '\0'; ++p) + if (p[0] == magic && isdigit(p[1]) && p[1] != '0') { + offset = snprintf(q, l, "%s", + argv[(++p)[0] - '0']); + if ((size_t)offset >= l) + err(1, "snprintf() failed"); + q += offset; + l -= offset; + } else + *q++ = *p; + + /* Terminate the command string. */ + *q = '\0'; + + /* Run the command. */ + if (debug) + (void)printf("%s\n", c); + else + if (exec_shell(c, shell, name)) + rval = 1; + } + + if (argc != 1) + errx(1, "expecting additional argument%s after \"%s\"", + (nargs - argc) ? "s" : "", argv[argc - 1]); + free(cmd); + free(c); + free(shell); + exit(rval); +} + +/* + * exec_shell -- + * Execute a shell command using passed use_shell and use_name + * arguments. + */ +static int +exec_shell(const char *command, char *use_shell, char *use_name) +{ + pid_t pid; + int omask, pstat; + sig_t intsave, quitsave; + + if (!command) /* just checking... */ + return(1); + + omask = sigblock(sigmask(SIGCHLD)); + switch(pid = vfork()) { + case -1: /* error */ + err(1, "vfork"); + case 0: /* child */ + (void)sigsetmask(omask); + execl(use_shell, use_name, "-c", command, (char *)NULL); + warn("%s", use_shell); + _exit(1); + } + intsave = signal(SIGINT, SIG_IGN); + quitsave = signal(SIGQUIT, SIG_IGN); + pid = waitpid(pid, &pstat, 0); + (void)sigsetmask(omask); + (void)signal(SIGINT, intsave); + (void)signal(SIGQUIT, quitsave); + return(pid == -1 ? -1 : pstat); +} + +void +usage(void) +{ + + (void)fprintf(stderr, + "usage: apply [-a magic] [-d] [-0123456789] command arguments ...\n"); + exit(1); +} -- cgit v1.2.3-56-ge451