From f316a2ed52195135a35e32d7096e876357c48c69 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Thu, 18 Sep 2014 20:03:23 +0000 Subject: initial commit: rc for execline-2.0.0.0 --- doc/tryexec.html | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 doc/tryexec.html (limited to 'doc/tryexec.html') diff --git a/doc/tryexec.html b/doc/tryexec.html new file mode 100644 index 0000000..2fcc7b6 --- /dev/null +++ b/doc/tryexec.html @@ -0,0 +1,67 @@ + + + + + execline: the tryexec command + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `tryexec` program

+ +

+tryexec executes into a command line, with a fallback. +

+ +

Interface

+ +

+ In an execlineb script: +

+ +

+     tryexec [ -n ] [ -c ] [ -l ] [ -a argv0 ] { prog1... } prog2...
+

+ +

tryexec reads prog1... in a +block. It then executes into it, +completely forgetting prog2...
If for some reason the execve() fails - for instance, +a non-executable prog1 - then tryexec executes +into prog2... instead.

+ +

Options

+ +

-n : reverse prog1... and prog2...'s +role. The latter becomes the main execution path and the former becomes +the fallback.

+ +

+ The -c, -l and -a options have the same +semantics as with the exec program. +

+ +

Notes

+ +

tryexec prog1... "" prog2... would be +equivalent to +sh -c 'exec prog1... || exec prog2...', if +such a shell construct existed. Unfortunately, the shell language does +not offer that functionality.

+ + + -- cgit v1.3.1

The tryexec program

Interface

Options

Notes

The `tryexec` program