~ubuntu-branches/ubuntu/oneiric/openafs/oneiric-201305130334

« back to all changes in this revision

Viewing changes to doc/man-pages/man1/symlink_remove.1

  • Committer: Bazaar Package Importer
  • Author(s): Russ Allbery
  • Date: 2008-09-22 19:07:02 UTC
  • mfrom: (12.1.14 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080922190702-59m13d7kn6gkw32d
Tags: 1.4.7.dfsg1-6
* Apply upstream patch to free /proc entries in the correct order.
  Thanks, Marc Dionne.  (Closes: #493914)
* Apply upstream deltas to support 2.6.27 kernels and to stop using
  COMMON_KERN_CFLAGS for all 2.6 kernels uniformly, which fixes
  problems on amd64 with newer kernels.  Thanks, Björn Torkelsson.
  (LP: #267504)
* Translation updates:
  - Swedish, thanks Martin Bagge.  (Closes: #493120)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.rn '' }`
 
2
''' $RCSfile$$Revision$$Date$
 
3
'''
 
4
''' $Log$
 
5
'''
 
6
.de Sh
 
7
.br
 
8
.if t .Sp
 
9
.ne 5
 
10
.PP
 
11
\fB\\$1\fR
 
12
.PP
 
13
..
 
14
.de Sp
 
15
.if t .sp .5v
 
16
.if n .sp
 
17
..
 
18
.de Ip
 
19
.br
 
20
.ie \\n(.$>=3 .ne \\$3
 
21
.el .ne 3
 
22
.IP "\\$1" \\$2
 
23
..
 
24
.de Vb
 
25
.ft CW
 
26
.nf
 
27
.ne \\$1
 
28
..
 
29
.de Ve
 
30
.ft R
 
31
 
 
32
.fi
 
33
..
 
34
'''
 
35
'''
 
36
'''     Set up \*(-- to give an unbreakable dash;
 
37
'''     string Tr holds user defined translation string.
 
38
'''     Bell System Logo is used as a dummy character.
 
39
'''
 
40
.tr \(*W-|\(bv\*(Tr
 
41
.ie n \{\
 
42
.ds -- \(*W-
 
43
.ds PI pi
 
44
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
 
45
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
 
46
.ds L" ""
 
47
.ds R" ""
 
48
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
 
49
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
 
50
'''   such as .IP and .SH, which do another additional levels of
 
51
'''   double-quote interpretation
 
52
.ds M" """
 
53
.ds S" """
 
54
.ds N" """""
 
55
.ds T" """""
 
56
.ds L' '
 
57
.ds R' '
 
58
.ds M' '
 
59
.ds S' '
 
60
.ds N' '
 
61
.ds T' '
 
62
'br\}
 
63
.el\{\
 
64
.ds -- \(em\|
 
65
.tr \*(Tr
 
66
.ds L" ``
 
67
.ds R" ''
 
68
.ds M" ``
 
69
.ds S" ''
 
70
.ds N" ``
 
71
.ds T" ''
 
72
.ds L' `
 
73
.ds R' '
 
74
.ds M' `
 
75
.ds S' '
 
76
.ds N' `
 
77
.ds T' '
 
78
.ds PI \(*p
 
79
'br\}
 
80
.\"     If the F register is turned on, we'll generate
 
81
.\"     index entries out stderr for the following things:
 
82
.\"             TH      Title 
 
83
.\"             SH      Header
 
84
.\"             Sh      Subsection 
 
85
.\"             Ip      Item
 
86
.\"             X<>     Xref  (embedded
 
87
.\"     Of course, you have to process the output yourself
 
88
.\"     in some meaninful fashion.
 
89
.if \nF \{
 
90
.de IX
 
91
.tm Index:\\$1\t\\n%\t"\\$2"
 
92
..
 
93
.nr % 0
 
94
.rr F
 
95
.\}
 
96
.TH SYMLINK_REMOVE 1 "OpenAFS" "25/Dec/2007" "AFS Command Reference"
 
97
.UC
 
98
.if n .hy 0
 
99
.if n .na
 
100
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 
101
.de CQ          \" put $1 in typewriter font
 
102
.ft CW
 
103
'if n "\c
 
104
'if t \\&\\$1\c
 
105
'if n \\&\\$1\c
 
106
'if n \&"
 
107
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
 
108
'.ft R
 
109
..
 
110
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
 
111
.       \" AM - accent mark definitions
 
112
.bd B 3
 
113
.       \" fudge factors for nroff and troff
 
114
.if n \{\
 
115
.       ds #H 0
 
116
.       ds #V .8m
 
117
.       ds #F .3m
 
118
.       ds #[ \f1
 
119
.       ds #] \fP
 
120
.\}
 
121
.if t \{\
 
122
.       ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 
123
.       ds #V .6m
 
124
.       ds #F 0
 
125
.       ds #[ \&
 
126
.       ds #] \&
 
127
.\}
 
128
.       \" simple accents for nroff and troff
 
129
.if n \{\
 
130
.       ds ' \&
 
131
.       ds ` \&
 
132
.       ds ^ \&
 
133
.       ds , \&
 
134
.       ds ~ ~
 
135
.       ds ? ?
 
136
.       ds ! !
 
137
.       ds /
 
138
.       ds q
 
139
.\}
 
140
.if t \{\
 
141
.       ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 
142
.       ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 
143
.       ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 
144
.       ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 
145
.       ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 
146
.       ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
 
147
.       ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
 
148
.       ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 
149
.       ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
 
150
.\}
 
151
.       \" troff and (daisy-wheel) nroff accents
 
152
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 
153
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 
154
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
 
155
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
 
156
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
 
157
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
 
158
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 
159
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 
160
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 
161
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 
162
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 
163
.ds ae a\h'-(\w'a'u*4/10)'e
 
164
.ds Ae A\h'-(\w'A'u*4/10)'E
 
165
.ds oe o\h'-(\w'o'u*4/10)'e
 
166
.ds Oe O\h'-(\w'O'u*4/10)'E
 
167
.       \" corrections for vroff
 
168
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 
169
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 
170
.       \" for low resolution devices (crt and lpr)
 
171
.if \n(.H>23 .if \n(.V>19 \
 
172
\{\
 
173
.       ds : e
 
174
.       ds 8 ss
 
175
.       ds v \h'-1'\o'\(aa\(ga'
 
176
.       ds _ \h'-1'^
 
177
.       ds . \h'-1'.
 
178
.       ds 3 3
 
179
.       ds o a
 
180
.       ds d- d\h'-1'\(ga
 
181
.       ds D- D\h'-1'\(hy
 
182
.       ds th \o'bp'
 
183
.       ds Th \o'LP'
 
184
.       ds ae ae
 
185
.       ds Ae AE
 
186
.       ds oe oe
 
187
.       ds Oe OE
 
188
.\}
 
189
.rm #[ #] #H #V #F C
 
190
.SH "NAME"
 
191
symlink_remove \- Remove a symbolic link.
 
192
.SH "SYNOPSIS"
 
193
\fBsymlink remove\fR <<\ [\fB\-name\fR]\ <\fIfile\ name\fR >>> [\fB\-help\fR]
 
194
.SH "DESCRIPTION"
 
195
The \fBsymlink remove\fR command removes a symbolic link to a file.
 
196
.SH "CAUTIONS"
 
197
The \fBsymlink\fR commands are only available on Windows platforms. On other
 
198
platforms, use the \fBrm\fR command.
 
199
.SH "OPTIONS"
 
200
.Ip "[\fB\-name\fR] <\fIfile name\fR>" 4
 
201
Specify one or more symbolic links to remove.  The \fB\-name\fR is optional, but
 
202
the file name is not.
 
203
.Ip "\fB\-help\fR" 4
 
204
Prints the online help for this command.  All other valid options are
 
205
ignored.
 
206
.SH "OUTPUT"
 
207
This command has no output except error and help messages.  If the command
 
208
is passed a real file instead of a symlink, it prints \*(L"symlink: \*(L'file name\*(R'
 
209
is not a symlink\*(R" instead of removing the file.
 
210
.SH "EXAMPLES"
 
211
Given that file \f(CWmylink\fR is a link pointing to file \f(CWmyfile\fR, the
 
212
following commands will remove the link \f(CWmylink\fR:
 
213
.PP
 
214
.Vb 2
 
215
\&   % symlink remove -name mylink
 
216
\&   % symlink remove mylink
 
217
.Ve
 
218
.SH "PRIVILEGE REQUIRED"
 
219
The issuer must have the \f(CWl\fR (look) and \f(CWd\fR (delete) permissions on
 
220
the ACL of the directory that houses the symlink.
 
221
.SH "SEE ALSO"
 
222
the \fIsymlink(1)\fR manpage,
 
223
the \fIsymlink_list(1)\fR manpage,
 
224
the \fIsymlink_make(1)\fR manpage
 
225
.SH "COPYRIGHT"
 
226
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
 
227
.PP
 
228
This documentation is covered by the BSD License as written in the
 
229
doc/LICENSE file. This man page was written by Jason Edgecombe for
 
230
OpenAFS.
 
231
 
 
232
.rn }` ''
 
233
.IX Title "SYMLINK_REMOVE 1"
 
234
.IX Name "symlink_remove - Remove a symbolic link."
 
235
 
 
236
.IX Header "NAME"
 
237
 
 
238
.IX Header "SYNOPSIS"
 
239
 
 
240
.IX Header "DESCRIPTION"
 
241
 
 
242
.IX Header "CAUTIONS"
 
243
 
 
244
.IX Header "OPTIONS"
 
245
 
 
246
.IX Item "[\fB\-name\fR] <\fIfile name\fR>"
 
247
 
 
248
.IX Item "\fB\-help\fR"
 
249
 
 
250
.IX Header "OUTPUT"
 
251
 
 
252
.IX Header "EXAMPLES"
 
253
 
 
254
.IX Header "PRIVILEGE REQUIRED"
 
255
 
 
256
.IX Header "SEE ALSO"
 
257
 
 
258
.IX Header "COPYRIGHT"
 
259