1just-man-pages/condor_chirp(1G)eneral Commands Manujaulst-man-pages/condor_chirp(1)
2
3
4

Name

6       condor_chirp Access files or job ClassAd from an executing job
7

Synopsis

9       condor_chirp [ -help ]
10
11       condor_chirp fetch RemoteFileName LocalFileName
12
13       condor_chirp  put  [  -mode  mode  ]  [  -perm UnixPerm ] LocalFileName
14       RemoteFileName
15
16       condor_chirp remove RemoteFileName
17
18       condor_chirp get_job_attr JobAttributeName
19
20       condor_chirp set_job_attr JobAttributeName AttributeValue
21
22       condor_chirp ulog Message
23

Description

25       condor_chirp is run from a user job while executing. It accesses  files
26       or  job  ClassAd  attributes  on the submit machine. Files can be read,
27       written or removed. Job attributes can be read, and most attributes can
28       be updated.
29
30       Descriptions  using the terms local and remote are given from the point
31       of view of the executing program.
32
33       If the input file name for put is a dash,  condor_chirp  uses  standard
34       input  as the source. If the output file name for fetch is a dash, con‐
35       dor_chirp writes to standard output instead of a local file.
36
37       Jobs that use condor_chirp must have the  attribute  WantIOProxyset  to
38       Truein the job ad. To do this, place
39
40       +WantIOProxy = true
41
42       in the submit description file for the job.
43
44       condor_chirp  only works for jobs run in the vanilla, parallel and java
45       universes.
46
47       The optional -mode mode argument is one or more of the following  char‐
48       acters describing the RemoteFileName file.
49
50          * w: open for writing
51
52          * a: force all writes to append
53
54          * t: truncate before use
55
56          * c: create the file, if it does not exist
57
58          * x: fail if 'c' is given, and the file already exists
59
60       The  optional -perm UnixPerm argument describes the file access permis‐
61       sions in a Unix format (for example, 660).
62

Options

64       -help
65
66          Display usage information and exit.
67
68
69
70       fetch
71
72          Copy the RemoteFileName from  the  submit  machine  to  the  execute
73          machine.
74
75
76
77       remove
78
79          Remove the RemoteFileName file from the submit machine.
80
81
82
83       put
84
85          Copy  the  LocalFileName  from  the  execute  machine  to the submit
86          machine. Perm is the unix permission to open the file with.
87
88
89
90       get_job_attr
91
92          Prints the named job ClassAd attribute to standard output.
93
94
95
96       set_job_attr
97
98          Sets the named job ClassAd attribute with the given attribute value.
99
100
101
102       ulog
103
104          Appends a message to the job's user log.
105
106
107

Examples

109       To copy a file from the submit machine to the execute machine while the
110       user job is running, run
111
112       % condor_chirp fetch remotefile localfile
113
114       To  print  to  standard  output the value of the Requirementsexpression
115       from within a running job, run
116
117       % condor_chirp get_job_attr Requirements
118
119       Note that the remote (submit-side) directory path is  relative  to  the
120       submit directory, and the local (execute-side) directory is relative to
121       the current directory of the running program.
122
123       To append the word "foo" to a file on the submit machine, run
124
125       % echo foo | condor_chirp put -mode wat - RemoteFile
126
127       To append the message "Hello World" to the user log, run
128
129       % condor_chirp ulog "Hello World"
130

Exit Status

132       condor_chirp will exit with a status value of 0  (zero)  upon  success,
133       and it will exit with the value 1 (one) upon failure.
134

Author

136       Condor Team, University of Wisconsin-Madison
137

139       Copyright (C) 1990-2009 Condor Team, Computer Sciences Department, Uni‐
140       versity  of  Wisconsin-Madison,  Madison,  WI.  All  Rights   Reserved.
141       Licensed under the Apache License, Version 2.0.
142
143       See   the   Condor   Version   7.4.2  Manual  or  http://www.condorpro‐
144       ject.org/licensefor additional notices. condor-admin@cs.wisc.edu
145
146
147
148                                     date       just-man-pages/condor_chirp(1)
Impressum