summaryrefslogtreecommitdiffstats
path: root/man/man8/puppet-parser.8
diff options
context:
space:
mode:
Diffstat (limited to 'man/man8/puppet-parser.8')
-rw-r--r--man/man8/puppet-parser.871
1 files changed, 71 insertions, 0 deletions
diff --git a/man/man8/puppet-parser.8 b/man/man8/puppet-parser.8
new file mode 100644
index 000000000..0029907e6
--- /dev/null
+++ b/man/man8/puppet-parser.8
@@ -0,0 +1,71 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "PUPPET\-PARSER" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.
+.SH "NAME"
+\fBpuppet\-parser\fR \- Interact directly with the parser\.
+.
+.SH "SYNOPSIS"
+puppet parser \fIaction\fR
+.
+.SH "OPTIONS"
+Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR is a valid configuration parameter, so you can specify \fB\-\-server <servername>\fR as an argument\.
+.
+.P
+See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
+.
+.TP
+\-\-mode MODE
+The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
+.
+.TP
+\-\-render\-as FORMAT
+The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
+.
+.TP
+\-\-verbose
+Whether to log verbosely\.
+.
+.TP
+\-\-debug
+Whether to log debug information\.
+.
+.SH "ACTIONS"
+.
+.TP
+\fBvalidate\fR \- Validate the syntax of one or more Puppet manifests\.
+\fBSYNOPSIS\fR
+.
+.IP
+puppet parser validate [\fImanifest\fR] [\fImanifest\fR \.\.\.]
+.
+.IP
+\fBDESCRIPTION\fR
+.
+.IP
+This action validates Puppet DSL syntax without compiling a catalog or syncing any resources\. If no manifest files are provided, it will validate the default site manifest\.
+.
+.IP
+\fBRETURNS\fR
+.
+.IP
+Nothing, or the first syntax error encountered\.
+.
+.SH "EXAMPLES"
+\fBvalidate\fR
+.
+.P
+Validate the default site manifest at /etc/puppet/manifests/site\.pp:
+.
+.P
+$ puppet parser validate
+.
+.P
+Validate two arbitrary manifest files:
+.
+.P
+$ puppet parser validate init\.pp vhost\.pp
+.
+.SH "COPYRIGHT AND LICENSE"
+Copyright 2011 by Puppet Labs Apache 2 license; see COPYING