.\" sncfgtemplate.8: auto-generated, DO NOT EDIT
.\"
.\" Copyright 2010-2014. Quantum Corporation. All Rights Reserved.
.\" StorNext is either a trademark or registered trademark of
.\" Quantum Corporation in the US and/or other countries.
.\"
.\" Code start macro
.de Cs
.sp
.ft C
.in +0.3i
.nf
..
.\" Code end macro
.de Ce
.fi
.in -0.3i
.ft R
..
.TH SNCFGTEMPLATE 8 "June 2014" "Xsan File System"
.SH NAME
sncfgtemplate \- Output a Xsan Volume configuration file
.SH SYNOPSIS
.na
.nh
.HP
.B sncfgtemplate -n
.I VolName
.RB [ -M \ \fIoutput_format\fP]
.HP
.B sncfgtemplate -h
.ad
.hy
.SH DESCRIPTION
The \fBsncfgtemplate\fR program will output a template Xsan
file system configuration file with the given name to stdout.  This
can be redirected to a file and edited.  When the configuration file
is correct for the file system being created, it can be installed
using
.BR sncfginstall (8),
and made with
.BR cvmkfs (8).
.PP
\fBNote:\fR the standard way to create a new configuration file on the
commandline is via
.BR sncfgedit (8).
.SH OPTIONS
.IP \fB\-h\fR
Display usage.
.IP "\fB\-n \fIVolName\fR"
Required. The name of the file system whose config is to be created.
.IP "\fB\-M \fImsg_format\fR"
Specify \fIXML\fR if you want messages to come back in XML format.
This defaults to ASCII.
.SH EXIT VALUES
\fBsncfgtemplate\fR will return 0 on success and non-zero on failure.
.SH EXAMPLES
List usage:
.Cs
# sncfgtemplate -h
Usage: sncfgtemplate -n <fs_name>
  -n            Name of file system
  -M            Message format (default ASCII)
  -h            This usage
.Ce
.PP
Dump a template config to a temporary file:
.Cs
# sncfgtemplate -n snfs1 > /tmp/myconfig
.Ce
.SH "SEE ALSO"
.BR sncfginstall (8),
.BR cvmkfs (8),
.BR snfs_config (5)