components/ruby/hiera/files/hiera.1
author Kristina Tripp <Kristina.Tripp@oracle.com>
Sat, 11 Oct 2014 09:09:04 -0700
branchs11u2-sru
changeset 3385 cb76431f36d7
permissions -rw-r--r--
PSARC/2014/275 Hiera 1.3.4 19137944 Add hiera to userland consolidation 19623766 hiera-19 package not installed if ruby-19 not installed
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3385
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     1
'\" t
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     2
.\" Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     3
.\"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     4
.\" Licensed under the Apache License, Version 2.0 (the "License");
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     5
.\" you may not use this file except in compliance with the License.
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     6
.\" You may obtain a copy of the License at
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     7
.\"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     8
.\"   http://www.apache.org/licenses/LICENSE-2.0
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
     9
.\"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    10
.\" Unless required by applicable law or agreed to in writing, software
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    11
.\" distributed under the License is distributed on an "AS IS" BASIS,
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    12
.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    13
.\" See the License for the specific language governing permissions and
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    14
.\" limitations under the License.
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    15
.TH hiera 1 
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    16
.SH NAME
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    17
hiera \- Lightweight Pluggable Hierarchical Database
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    18
.SH SYNOPSIS
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    19
.B hiera
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    20
[options] key [default value] [variable='text'...]
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    21
.SH DESCRIPTION
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    22
Lightweight Pluggable Hierarchical Database
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    23
.sp
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    24
The default value will be used if no value is found for the key. Scope
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    25
variables will be interpolated into %{variable} placeholders in the hierarchy and in
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    26
returned values.
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    27
.SH OPTIONS
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    28
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    29
.BR "-V, --version"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    30
Version information
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    31
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    32
.BR "-d, --debug"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    33
Show debugging information
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    34
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    35
.BR "-a, --array"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    36
Return all values as an array
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    37
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    38
.BR "-h, --hash"
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    39
Return all values as a hash
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    40
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    41
.BR "-c, --config "\fICONFIG\fR
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    42
Configuration file
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    43
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    44
.BR "-j, --json "\fISCOPE\fR
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    45
JSON format file to load scope from
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    46
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    47
.BR "-y, --yaml "\fISCOPE\fR
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    48
YAML format file to load scope from
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    49
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    50
.BR "-m, --mcollective "\fIIDENTITY\fR
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    51
Use facts from a node (via mcollective) as scope
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    52
.TP
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    53
.BR "-i, --inventory_service "\fIIDENTITY\fR
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    54
Use facts from a node (via Puppet's inventory service) as scope
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    55
.SH FILES
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    56
.BR /etc/hiera.yaml
cb76431f36d7 PSARC/2014/275 Hiera 1.3.4
Kristina Tripp <Kristina.Tripp@oracle.com>
parents:
diff changeset
    57
Configuration File