.\" @(#)$RCSfile: lfc-rm.man,v $ $Revision: 1.1.1.1 $ $Date: 2002/10/18 11:57:00 $ CERN IT-PDP/DM Jean-Philippe Baud
.\" Copyright (C) 1999-2011 by CERN/IT/PDP/DM, CERN/IT/GT/DMS
.\" All rights reserved
.\"
.TH LFC-RM 1 "$Date: 2011/11/04 11:57:00 $" LFC "LFC User Commands"
.SH NAME
lfc-rm \- remove LFC files or directories in the name server
.SH SYNOPSIS
.B lfc-rm
.RB [ -a ]
.RB [ -f ]
.RB [ -i ]
.IR filename ...
.LP
.B lfc-rm
.RB [ -f ]
.RB [ -i ]
.B -r
.IR dirname ...
.SH DESCRIPTION
.B lfc-rm
removes LFC files or directories in the name server.
For directories either
.B -r
or
.B -R
must be present.
For regular files, it calls
.B lfc_unlink
while for directories, it calls
.BR lfc_rmdir .
.LP
This requires write permission in the parent directory and the file itself.
If write permission on an entry is denied, the standard input is a terminal and
the
.B -f
option is not given, the prompt "override write protection" appears and if the
response is not
.BR y ,
the entry is not deleted.
Entries directly under a protected directory are never deleted.
.TP
.I path
specifies the LFC pathname.
If
.I path
does not start with
.BR / ,
it is prefixed by the content of the
.B LFC_HOME
environment variable.
.SH OPTIONS
The following options are supported:
.TP
.B -a
Remove the
.B metadata
information about a file
.B and
the
.B metadata
information about the replicas that it may have.
.B Remember
that this is a metadata-only operation, it does not remove the replicas physically from the disk.
Removing metadata entries about replicas without removing the replicas from the disks leads to
non-reachable files on disk.
Applies only to files, not directories.
.TP
.B -f
Do not give an error message if the file/directory does not exist.
.TP
.B -i
Request acknowledge before removing each individual entry.
.TP
.B -R
Recursive mode (equivalent to
.BR -r ).
.TP
.B -r
Recursive mode.
.SH EXIT STATUS
This program returns 0 if the operation was successful or >0 if the operation
failed.
.SH SEE ALSO
.BR Castor_limits(4) ,
.BR lfc_rmdir(3) ,
.B lfc_unlink(3)
.SH AUTHOR
\fBLCG Grid Deployment\fP Team