1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
\name{FileExists}
\alias{FileExists}
\alias{LockRemove}
\alias{LockFile}
\alias{WaitOthers}
\title{Files}
\description{
The function \code{FileExists} checks whether a file or a lock-file
exists
The function \code{LockRemove} removes a lock-file
}
\usage{
FileExists(file, printlevel=RFoptions()$basic$printlevel)
LockFile(file, printlevel=RFoptions()$basic$printlevel)
LockRemove(file)
WaitOthers(file, i, cores, ideal.processes=ceiling(cores * 1.25),
max.processes=ceiling(cores * 1.5),
distance=5, time=5, path="./")
}
\arguments{
\item{file}{name of the data file}
\item{printlevel}{if \code{PrintLevel<=1} no messages are displayed}
\item{i}{integer; current value of process, usually the number of a
loop index}
\item{cores}{the number of cores on the machine}
\item{ideal.processes,max.processes,distance}{integer. See Details}
\item{time}{in minutes a process waits until it rechecks its
environment}
\item{path}{the current path of \code{file}}
}
\details{
\code{FileExists} checks whether file or file.lock exists.
If none of them exists \code{file}.lock is created and hostname and
PID are written into \code{file}.lock. This is useful if several processes
use the same directory. Further, it is checked whether another process
has tried to create the same file in the same instance. In this case
\code{FileExists} returns for at least one of the processes that
\code{file}.lock has already been created.
\code{LockFile} is the same as \code{FileExists} except that it does
not check whether \code{file} already exists.
\command{WaitOthers} waits for others if more than \code{ideal.processes}
processes have
their value is less than \code{i}
or if more than \code{cores}
processes have
their value is less than \code{i}-\code{distance}.
It also waits if there are alreay \code{max.processes} are active.
Note that \command{WaitOthers} write a file with ending
\sQuote{.wait}, which is also deleted be \command{LockRemove}.
}
\value{
\code{FileExists} returns
\item{1}{if \code{file} already exists}
\item{2}{if \code{file}.lock already exists}
\item{3}{if \code{file}.lock was tried to be created, but another process
inferred and got priority}
\item{0}{otherwise, \code{file} and \code{file}.lock did not exist and
\code{file}.lock has been created}
}
\me
\examples{
\dontrun{
## the next command checks whether the file 'data.rda'
## or the file 'data.rda.lock' exists. If so, a positive
## value is returned. If not, the file 'data.rda.lock'
## is created and the value 0 returned.
FileExists("data.rda")
## the next command deletes the file 'data.rda.lock'
LockRemove("data.rda")
}
}
\keyword{file}
\keyword{utilities}
% LocalWords: FileExists LockRemove PrintLevel RFoptions PID Schlather url
|
