1RALSH(8)                                                              RALSH(8)
2
3
4
5Use  the  Puppet  RAL  to  directly  interact  with the system.puppet resource
6[-h|--help] [-d|--debug] [-v|--verbose] [-e|--edit]
7
8
9
10                         [-H|--host <host>] [-p|--param <param>] [-t|--types]
11                         type <name>
12
13
14       This command provides simple facilities for converting  current  system
15       state into Puppet code, along with some ability to use Puppet to affect
16       the current state.
17
18       By default, you must at least provide a type to list, which case puppet
19       resource  will tell you everything it knows about all instances of that
20       type. You can optionally specify an instance name, and puppet  resource
21       will only describe that single instance.
22
23       You  can  also  add  +--edit+  as an argument, and puppet resource will
24       write its output to a file, open that file in an editor, and then apply
25       the file as a Puppet transaction. You can easily use this to use Puppet
26       to make simple changes to a system.Note that any configuration  parame‐
27       ter  that´s  valid in the configuration file is also a valid long argu‐
28       ment. For example, ´ssldir´ is a valid configuration parameter, so  you
29       can specify ´--ssldir directory´ as an argument.
30
31       See   the   configuration  file  documentation  at  http://docs.puppet‐
32       labs.com/references/stable/configuration.html  for  the  full  list  of
33       acceptable  parameters.  A  commented list of all configuration options
34       can also be generated by running puppet with ´--genconfig´.
35
36       debug: Enable full debugging.
37
38       edit:
39
40       Write the results of the query to a file, open the file in  an  editor,
41       and read the file back in as an executable Puppet manifest.
42
43       host:
44
45       When  specified,  connect  to the resource server on the named host and
46       retrieve the list of resouces of the type specified.
47
48       help:
49
50       Print this help message.
51
52       param:
53
54       Add more parameters to be outputted from queries.
55
56       types:
57
58       List all available types.
59
60       verbose:
61
62       Print extra information.This example uses  puppet  resource  to  return
63       Puppet configuration for the user luke:
64
65
66
67            $ puppet resource user luke
68            user { ´luke´:
69              home => ´/home/luke´,
70              uid => ´100´,
71              ensure => ´present´,
72              comment => ´Luke Kanies,,,´,
73              gid => ´1000´,
74              shell => ´/bin/bash´,
75              groups => [´sysadmin´,´audio´,´video´,´puppet´]
76            }
77
78
79       Luke  KaniesCopyright (c) 2005-2007 Puppet Labs, LLC Licensed under the
80       GNU Public License
81
82
83
84                                  August 2010                         RALSH(8)
Impressum