'\" t
.\"     Title: gfrm
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 25 Dec 2014
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFRM" "1" "25 Dec 2014" "Gfarm" "Gfarm"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gfrm \- remove Gfarm files, directories, or file replicas
.SH "SYNOPSIS"
.HP \w'\fBgfrm\fR\ 'u
\fBgfrm\fR [\-frn] [\-h\ \fIfilesystem\-node\fR] [\-D\ \fIdomain\-name\fR] \fIgfarm\-URL\fR...
.SH "DESCRIPTION"
.PP
\fBgfrm\fR
removes each specified file\&. It does not remove directories unless the
\fB\-r\fR
option is specified\&.
.PP
With the
\fB\-h\fR
or
\fB\-D\fR
option,
\fBgfrm\fR
removes file replicas on the specified filesystem node(s)\&. A file replica cannot be removed when the number of replicas is less than gfarm\&.ncopy or gfarm\&.replicainfo extended attribute\&.
.SH "OPTIONS"
.PP
\fB\-f\fR
.RS 4
Ignores no such file or directory error\&.
.RE
.PP
\fB\-n\fR
.RS 4
Prints file names to be deleted, but does not delete them\&.
.RE
.PP
\fB\-r\fR
.RS 4
Removes all entries under the directories specified by the command\-line argument recursively\&.
.RE
.PP
\fB\-h\fR \fIfilesystem\-node\fR
.RS 4
Specifies a filesystem node from which file replicas will be removed\&.
.RE
.PP
\fB\-D\fR \fIdomain\-name\fR
.RS 4
Specifies a domain name of filesystem nodes on which file replicas will be removed\&.
.RE
.PP
\fB\-?\fR
.RS 4
Displays a list of command options\&.
.RE
.SH "SEE ALSO"
.PP
\fBgfncopy\fR(1),
\fBgfarm_attr\fR(5)