'\" t
.\"     Title: gfhostgroup
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 14 Jun 2012
.\"    Manual: Gfarm
.\"    Source: Gfarm
.\"  Language: English
.\"
.TH "GFHOSTGROUP" "1" "14 Jun 2012" "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"
gfhostgroup \- Gfarm hostgroup maintenance command
.SH "SYNOPSIS"
.HP \w'\fBgfhostgroup\fR\ 'u
\fBgfhostgroup\fR [\-P\ \fIpath\fR] [\fIhost\fR [[\fIhost\fR...]]]
.HP \w'\fBgfhostgroup\fR\ 'u
\fBgfhostgroup\fR [\-P\ \fIpath\fR] \-s\ \fIhost\fR \fIgroupname\fR
.HP \w'\fBgfhostgroup\fR\ 'u
\fBgfhostgroup\fR [\-P\ \fIpath\fR] \-r\ \fIhost\fR [[\fIhost\fR...]]
.SH "DESCRIPTION"
.PP
\fBgfhostgroup\fR
manages Gfarm host groups (so called
\fBfilesystem node group\fR
or
\fBfsngroup\fR
for short) in Gfarm file system\&. The host group is used by the
\fBReplication\-Attribute\-based File Replication\fR\&.
.PP
Default action displays all registered host groups\&. Any user can display the host groups\&. Gfarm administrators can set the host group of specified hosts by using
\fB\-s\fR
option, and the one also can remove the host group of specified hosts by using
\fB\-r\fR
option\&.
.SH "OPTIONS"
.PP
\fB\-P\fR path
.RS 4
This option specifies a pathname or a Gfarm URL to identify a metadata server which will be accessed by this command\&. If not specified, "/" is used as the default value\&.
.RE
.PP
\fB\-s\fR
.RS 4
Sets a host group for the specified host\&.
.RE
.PP
\fB\-r\fR
.RS 4
Removes a host group for the specified host(s)\&.
.RE
.SH "SEE ALSO"
.PP
\fBgfncopy\fR(1)