diff options
author | Mattias Andrée <maandree@member.fsf.org> | 2015-12-31 23:45:15 +0100 |
---|---|---|
committer | Mattias Andrée <maandree@member.fsf.org> | 2015-12-31 23:45:15 +0100 |
commit | 2edfa688d51080305a7c300bc10e4649bc5f484e (patch) | |
tree | d12a839c87aea5ff322feefb50a19d0ad8b31e6d /doc | |
parent | m (diff) | |
download | sat-2edfa688d51080305a7c300bc10e4649bc5f484e.tar.gz sat-2edfa688d51080305a7c300bc10e4649bc5f484e.tar.bz2 sat-2edfa688d51080305a7c300bc10e4649bc5f484e.tar.xz |
preserve working directory
Signed-off-by: Mattias Andrée <maandree@member.fsf.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/info/chap/invoking.texinfo | 9 | ||||
-rw-r--r-- | doc/info/chap/output.texinfo | 8 | ||||
-rw-r--r-- | doc/man/sat.1 | 12 | ||||
-rw-r--r-- | doc/man/satq.1 | 6 |
4 files changed, 31 insertions, 4 deletions
diff --git a/doc/info/chap/invoking.texinfo b/doc/info/chap/invoking.texinfo index 65c62b3..6afa45d 100644 --- a/doc/info/chap/invoking.texinfo +++ b/doc/info/chap/invoking.texinfo @@ -51,8 +51,13 @@ kill the parent. @command{sat} runs the specified command (@code{COMMAND...}) at a specified time (@code{TIME}). The job will run with -the same environment as @command{sat} has when it queues -the job. +the same environment and the same working directory as +@command{sat} has when it queues the job. The working +directory is determined by its absolute pathname@footnote{Most +probably the canonical pathname}, if no such directory +exists when the job is executed, the job's working directory +will be that of @command{satd}, which is always @file{/} +unless it was started with @option{-f}. @command{satq} lists all queued jobs to standard output. diff --git a/doc/info/chap/output.texinfo b/doc/info/chap/output.texinfo index d475706..4671dfb 100644 --- a/doc/info/chap/output.texinfo +++ b/doc/info/chap/output.texinfo @@ -14,6 +14,7 @@ The output for each job is formatted @example job: JOB-ID clock: CLOCK argc: ARGC remaining: REM argv[0]: ARGV0 time: TIME + wdir: WDIR argv: ARGV envp: ENVP @end example @@ -54,6 +55,13 @@ is @code{boottime}, this is formatted in the say way as formatted @code{YEAR-MM-DD HH:MM:SS} in 24-hour clock, local time. +@item WDIR +is the working directory the job will have. If that +directory does not exist when the job is executed, +the job's working directory will be that if this +daemon, which is always @file{/} unless @command{satd} +was started with @option{-f}. + @item ARGV is all arguments in the job's command line, including @code{ARGV0}. Each argument is quoted as necssary. diff --git a/doc/man/sat.1 b/doc/man/sat.1 index 77b1d77..93854b6 100644 --- a/doc/man/sat.1 +++ b/doc/man/sat.1 @@ -22,9 +22,17 @@ unless it is already running, and queue a specified to be executed at a selected .IR TIME . The job shall be executed with the same environment -variables as +variables and the same working directory (by +pathname) as .BR sat (1) -had when the job was queued. +had when the job was queued. However, if there is no +directory will the pathname matching the working +directory, when the job executes, the working directory +will be /, or whatever the working directory of +.BR satd (1) +(if +.BR satd (1) +is running in the foreground.) .PP The .I TIME diff --git a/doc/man/satq.1 b/doc/man/satq.1 index 630b5a2..082a7ac 100644 --- a/doc/man/satq.1 +++ b/doc/man/satq.1 @@ -17,6 +17,7 @@ indented. The output for each job is formatted .nf job: \fIJOB-ID\fP clock: \fICLOCK\fP argc: \fIARGC\fP remaining: \fIREM\fP argv[0]: \fIARGV0\fP time: \fITIME\fP + wdir: \fIWDIR\fP argv: \fIARGV\fP envp: \fIENVP\fP .fi @@ -75,6 +76,11 @@ it is formatted .IB YEAR - MM - DD \ HH : MM : SS in 24-hour clock, local time. .TP +.I WDIR +is the working directory the job will have. However, +if that directory one longer exists, its working +directory will be /. +.TP .I ARGV is all arguments in the job's command line, including .IR ARGV0 . |