components/ruby/hiera/files/hiera.1

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