From 3f2d136505370bb2c8ccd6f66a33c559847b3ab4 Mon Sep 17 00:00:00 2001 From: Alan Jenkins Date: Sat, 16 Dec 2017 10:48:12 +0000 Subject: [PATCH] man: generalize "binary" to "program" (#7668) Systemd services are permitted to be scripts, as well as binary executables. The same also applies to the underlying /sbin/mount and /sbin/swapon. It is not necessary for the user to consider what type of program file these are. Nor is it necessary with systemd-nspawn, to distinguish between init as a "binary" v.s. a user-specified "program". Also fix a couple of grammar nits in the modified sentences. --- man/systemd-nspawn.xml | 16 ++++++++-------- man/systemd-run.xml | 4 ++-- man/systemd-socket-activate.xml | 7 ++++--- man/systemd.mount.xml | 2 +- man/systemd.service.xml | 4 ++-- man/systemd.swap.xml | 2 +- 6 files changed, 18 insertions(+), 17 deletions(-) diff --git a/man/systemd-nspawn.xml b/man/systemd-nspawn.xml index 3dbdf37..b3f8eb6 100644 --- a/man/systemd-nspawn.xml +++ b/man/systemd-nspawn.xml @@ -149,7 +149,7 @@ Options If option is specified, the arguments - are used as arguments for the init binary. Otherwise, + are used as arguments for the init program. Otherwise, COMMAND specifies the program to launch in the container, and the remaining arguments are used as arguments for this program. If is not used and @@ -273,12 +273,12 @@ Invoke the shell or specified program as process ID (PID) 2 instead of PID 1 (init). By - default, if neither this option nor is used, the selected binary is run as process with - PID 1, a mode only suitable for programs that are aware of the special semantics that the process with PID 1 - has on UNIX. For example, it needs to reap all processes reparented to it, and should implement + default, if neither this option nor is used, the selected program is run as the process + with PID 1, a mode only suitable for programs that are aware of the special semantics that the process with + PID 1 has on UNIX. For example, it needs to reap all processes reparented to it, and should implement sysvinit compatible signal handling (specifically: it needs to reboot on SIGINT, reexecute on SIGTERM, reload configuration on SIGHUP, and so on). With a minimal stub init - process is run as PID 1 and the selected binary is executed as PID 2 (and hence does not need to implement any + process is run as PID 1 and the selected program is executed as PID 2 (and hence does not need to implement any special semantics). The stub init process will reap processes as necessary and react appropriately to signals. It is recommended to use this mode to invoke arbitrary commands in containers, unless they have been modified to run correctly as PID 1. Or in other words: this switch should be used for pretty much all commands, @@ -291,9 +291,9 @@ - Automatically search for an init binary and invoke it as PID 1, instead of a shell or a user + Automatically search for an init program and invoke it as PID 1, instead of a shell or a user supplied program. If this option is used, arguments specified on the command line are used as arguments for the - init binary. This option may not be combined with . + init program. This option may not be combined with . The following table explains the different modes of invocation and relationship to (see above): @@ -322,7 +322,7 @@ specified - An init binary as automatically searched and run as PID 1 in the container. The passed parameters are used as invocation parameters for this process. + An init program is automatically searched for and run as PID 1 in the container. The passed parameters are used as invocation parameters for this process. diff --git a/man/systemd-run.xml b/man/systemd-run.xml index 9db6a26..7bcea9b 100644 --- a/man/systemd-run.xml +++ b/man/systemd-run.xml @@ -352,8 +352,8 @@ All command line arguments after the first non-option argument become part of the command line of the launched - process. If a command is run as service unit, its first argument - needs to be an absolute binary path. + process. If a command is run as service unit, the first argument + needs to be an absolute program path. diff --git a/man/systemd-socket-activate.xml b/man/systemd-socket-activate.xml index 79e35dd..ff9e775 100644 --- a/man/systemd-socket-activate.xml +++ b/man/systemd-socket-activate.xml @@ -62,8 +62,9 @@ Description - systemd-socket-activate may be used to launch a socket-activated service binary from the command - line for testing purposes. It may also be used to launch individual instances of the service binary per connection. + systemd-socket-activate may be used to launch a socket-activated service program from the + command line for testing purposes. It may also be used to launch individual instances of the service program per + connection. The daemon to launch and its options should be specified @@ -97,7 +98,7 @@ - Launch an instance of the service binary for each connection and pass the connection + Launch an instance of the service program for each connection and pass the connection socket. diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml index 663e7fa..9160db6 100644 --- a/man/systemd.mount.xml +++ b/man/systemd.mount.xml @@ -71,7 +71,7 @@ systemd.exec5, which define the execution environment the mount8 - binary is executed in, and in + program is executed in, and in systemd.kill5, which define the way the processes are terminated, and in systemd.resource-control5, diff --git a/man/systemd.service.xml b/man/systemd.service.xml index b0aee33..b98264c 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -228,10 +228,10 @@ PrivateNetwork=. Behavior of is very similar to ; however, actual execution - of the service binary is delayed until all active jobs are dispatched. This may be used to avoid interleaving + of the service program is delayed until all active jobs are dispatched. This may be used to avoid interleaving of output of shell services with the status output on the console. Note that this type is useful only to improve console output, it is not useful as a general unit ordering tool, and the effect of this service type - is subject to a 5s time-out, after which the service binary is invoked anyway. + is subject to a 5s time-out, after which the service program is invoked anyway. diff --git a/man/systemd.swap.xml b/man/systemd.swap.xml index 707b04b..acedb9f 100644 --- a/man/systemd.swap.xml +++ b/man/systemd.swap.xml @@ -72,7 +72,7 @@ systemd.exec5, which define the execution environment the swapon8 - binary is executed in, in + program is executed in, in systemd.kill5, which define the way these processes are terminated, and in -- 2.7.4