.\" @(#)$RCSfile: dpm-addpool.man,v $ $Revision: 3156 $ $Date: 2010-02-05 10:50:58 +0100 (Fri, 05 Feb 2010) $ CERN Jean-Philippe Baud
.\" Copyright (C) 2004-2010 by CERN
.\" All rights reserved
.\"
.TH DPM-ADDPOOL 1 "$Date: 2010-02-05 10:50:58 +0100 (Fri, 05 Feb 2010) $" LCG "DPM Administrator Commands"
.SH NAME
dpm-addpool \- define a new disk pool
.SH SYNOPSIS
.B dpm-addpool
.BI --poolname " pool_name"
.BI --def_filesize " defsize"
[
.BI --def_lifetime " def_lifetime"
] [
.BI --def_pintime " defpintime"
] [
.BI --gc_start_thresh " perc"
] [
.BI --gc_stop_thresh " perc"
] [
.BI --gid " pool_gids"
] [
.BI --group " pool_groups"
] [
.B --help
] [
.BI --max_lifetime " max_lifetime"
] [
.BI --max_pintime " maxpintime"
] [
.BI --ret_policy " retention_policy"
] [
.BI --s_type " space_type"
]
.SH DESCRIPTION
.B dpm-addpool
defines a new disk pool.
.LP
This command requires ADMIN privilege.
.SH OPTIONS
.TP
.I pool_name
specifies the disk pool name.
It must be at most CA_MAXPOOLNAMELEN characters long.
.TP
.I defsize
specifies the default amount of space reserved for a file.
This is by default in bytes, but the number may also be post-fixed
with 'k', 'M' or 'G' for kilobyte, Megabyte and Gigabyte respectively.
.TP
.I def_lifetime
specifies the default time a space or volatile file is kept in the system (in seconds).
.TP
.I defpintime
specifies the default time a file is kept on a given disk (in seconds).
.TP
.I gc_start_thresh
specifies the minimum free space in the pool.
If the percentage of free space goes below this value, the garbage collector
is started. Default is 0.
.TP
.I gc_stop_thresh
specifies the percentage of free space in the pool above which the garbage
collector is stopped. Default is 0.
.TP
.I max_lifetime
specifies the maximum time a space or volatile file is kept in the system (in seconds).
.TP
.I maxpintime
specifies the maximum time a file is kept on a given disk (in seconds).
.TP 
.I pool_gids
if not zero, the disk pool is restricted to this comma separated list of group gids.
.TP 
.I pool_groups
if set and not "ALL", the disk pool is restricted to this comma separated list
of group names.
.TP
.I retention_policy
specifies the retention policy supported by the disk pool. It can be
.BR R " (for Replica),"
.BR O " (for Output)"
or
.BR C " (for Custodial)."
Default is
.BR R .
.TP
.I space_type
indicates the type of space supported in the disk pool. It can be
.BR V " (for Volatile),"
.BR D " (for Durable),"
.BR P " (for Permanent)"
or
.BR - " (to accept any type)." 
The latter is the default.
.SH EXAMPLE
.nf
.ft CW
	dpm-addpool --poolname Volatile --def_filesize 200M --s_type V
.ft
.fi
.SH EXIT STATUS
This program returns 0 if the operation was successful or >0 if the operation
failed.
.SH SEE ALSO
.BR dpm(1) ,
.B dpm_addpool(3)