aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMattias Andrée <maandree@member.fsf.org>2015-12-31 23:45:15 +0100
committerMattias Andrée <maandree@member.fsf.org>2015-12-31 23:45:15 +0100
commit2edfa688d51080305a7c300bc10e4649bc5f484e (patch)
treed12a839c87aea5ff322feefb50a19d0ad8b31e6d /doc
parentm (diff)
downloadsat-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.texinfo9
-rw-r--r--doc/info/chap/output.texinfo8
-rw-r--r--doc/man/sat.112
-rw-r--r--doc/man/satq.16
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 .