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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gfncopy</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry">
<a name="gfncopy.1"></a><div class="titlepage"></div>
<div class="refnamediv">
<a name="name"></a><h2>Name</h2>
<p>gfncopy — Manipulate number of file replicas automatically created</p>
</div>
<div class="refsynopsisdiv">
<a name="synopsis"></a><h2>Synopsis</h2>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-vh] <em class="replaceable"><code>path</code></em> </p></div>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-vh] [ -C | -M ] -s <em class="replaceable"><code>NCOPY</code></em> <em class="replaceable"><code>path</code></em> </p></div>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-vh] [ -C | -M ] -S <em class="replaceable"><code>REPATTR</code></em> <em class="replaceable"><code>path</code></em> </p></div>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-vh] -r <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>path</code></em>...]</p></div>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-vh] -c <em class="replaceable"><code>path</code></em> </p></div>
<div class="cmdsynopsis"><p><code class="command">gfncopy</code> [-v] -w [-t <em class="replaceable"><code>TIMEOUT</code></em>] <em class="replaceable"><code>path</code></em> [<em class="replaceable"><code>path</code></em>...]</p></div>
</div>
<div class="refsect1">
<a name="description"></a><h2>DESCRIPTION</h2>
<p>gfncopy manipulates the number of file replicas automatically
created. When no option is specified, it displays the specified
number of file replicas. When replication attributes of both NCOPY
and REPATTR are set to a file, these attributes are displayed in two
lines. With the <code class="option">-v</code> option, it also displays path
names up to the ancient directory that specifies the number of file
repilcas.
</p>
</div>
<div class="refsect1">
<a name="options"></a><h2>OPTIONS</h2>
<div class="variablelist"><dl class="variablelist">
<dt><span class="term"><code class="option">-s</code> <em class="parameter"><code>NCOPY</code></em></span></dt>
<dd><p>specifies the attribute for automatic replication represented by
the number of file replicas to a file or directory.
<em class="parameter"><code>NCOPY</code></em> is stored in the extended
attribute of gfarm.ncopy.
</p></dd>
<dt><span class="term"><code class="option">-S</code> <em class="parameter"><code>REPATTR</code></em></span></dt>
<dd>
<p>specifies the attribute for automatic replication represented by
host groups to a file or directory.</p>
<p>
When both <em class="parameter"><code>NCOPY</code></em>
and <em class="parameter"><code>REPATTR</code></em> are set to a same file,
the following number of replicas will be created.
If N is the total number of replicas specified by REPATTR,
and N is greater than NCOPY, at least N replicas will be created.
Otherwise, replicas will be created according to REPATTR,
and more replicas will be added until total number of replicas reaches NCOPY.
<em class="parameter"><code>REPATTR</code></em> is stored in the extended
attribute of gfarm.replicainfo.
</p>
<p>
a <em class="parameter"><code>REPATTR</code></em> is represented by the following BNF:
</p>
<div class="literallayout"><p><br>
<repattr> ::= <an_attr> | <an_attr> ',' <repattr><br>
<an_attr> ::= <host_group> ':' <num_rep><br>
<host_group> ::= <string><br>
<num_rep> ::= <integer><br>
<br>
e.g.)<br>
group0:2<br>
group0:1,group1:2,group2:3<br>
</p></div>
</dd>
<dt><span class="term"><code class="option">-C</code></span></dt>
<dd><p>
If the replication attribute exists already on the
file, <span class="command"><strong>gfncopy</strong></span> with the <code class="option">-s</code>
or <code class="option">-S</code> options fails.</p></dd>
<dt><span class="term"><code class="option">-M</code></span></dt>
<dd><p>
If the replication attribute does not exist on the
file, <span class="command"><strong>gfncopy</strong></span> with the <code class="option">-s</code>
or <code class="option">-S</code> options fails.</p></dd>
<dt><span class="term"><code class="option">-r</code></span></dt>
<dd>
<p>removes the specified replication attributes.</p>
<p>
The <em class="replaceable"><code>path</code></em> can be specified multiple times.
</p>
</dd>
<dt><span class="term"><code class="option">-c</code></span></dt>
<dd><p>displays the number of file repicas the file really has.</p></dd>
<dt><span class="term"><code class="option">-w</code></span></dt>
<dd>
<p>checks whether or not the file replicas have been created
according to the replication attributes (NCOPY or REPATTR), otherwise
waits for the completion of the replication.</p>
<p>
The <em class="replaceable"><code>path</code></em> can be specified multiple times.
</p>
<p>
If the <em class="replaceable"><code>path</code></em> is a directory, files in
subdirectories are checked.
</p>
</dd>
<dt><span class="term"><code class="option">-t</code> <em class="parameter"><code>TIMEOUT</code></em></span></dt>
<dd><p>
specifies the time in seconds for the <code class="option">-w</code> option to
wait until automatic replication starts.
Timeout does not occur while the replication is running.
Default is 30 seconds.
</p></dd>
<dt><span class="term"><code class="option">-h</code></span></dt>
<dd><p>processes symbolic link instead of any referenced files.</p></dd>
<dt><span class="term"><code class="option">-v</code></span></dt>
<dd><p>displays verbose messages.</p></dd>
<dt><span class="term"><code class="option">-?</code></span></dt>
<dd><p>displays a list of command options.</p></dd>
</dl></div>
</div>
<div class="refsect1">
<a name="see-also"></a><h2>SEE ALSO</h2>
<p>
<span class="citerefentry"><span class="refentrytitle">gfhostgroup</span>(1)</span>,
<span class="citerefentry"><span class="refentrytitle">gfarm_attr</span>(5)</span>
</p>
</div>
</div></body>
</html>
|
