salt-ssh(1)

NAME

   salt-ssh - salt-ssh Documentation

SYNOPSIS

      salt-ssh '*' [ options ] sys.doc

      salt-ssh -E '.*' [ options ] sys.doc cmd

DESCRIPTION

   Salt  SSH  allows  for  salt routines to be executed using only SSH for
   transport

OPTIONS

   -r, --raw, --raw-shell
          Execute a raw shell command.

   --priv Specify the SSH private key file to be used for authentication.

   --roster
          Define which roster system to use, this defines  if  a  database
          backend,  scanner,  or  custom roster system is used. Default is
          the flat file roster.

   --roster-file
          Define an alternative  location  for  the  default  roster  file
          location.  The default roster file is called roster and is found
          in the same directory as the master config file.

          New in version 2014.1.0.

   --refresh, --refresh-cache
          Force a refresh of the master side data cache  of  the  target's
          data.  This is needed if a target's grains have been changed and
          the auto refresh timeframe has not been reached.

   --max-procs
          Set the number of concurrent minions to communicate  with.  This
          value  defines  how  many  processes  are opened up at a time to
          manage  connections,  the  more  running  process   the   faster
          communication should be, default is 25.

   -i, --ignore-host-keys
          Disables  StrictHostKeyChecking  to  relax acceptance of new and
          unknown host keys.

   --no-host-keys
          Fully ignores ssh host keys which by  default  are  honored  and
          connections  would ask for approval. Useful if the host key of a
          remote  server  has  changed  and   would   still   error   with
          --ignore-host-keys.

   --passwd
          Set the default password to attempt to use when authenticating.

   --key-deploy
          Set  this  flag to attempt to deploy the authorized ssh key with
          all minions.  This  combined  with  --passwd  can  make  initial
          deployment of keys very fast and easy.

   --version
          Print the version of Salt that is running.

   --versions-report
          Show program's dependencies and version number, and then exit

   -h, --help
          Show the help message and exit

   -c CONFIG_DIR, --config-dir=CONFIG_dir
          The location of the Salt configuration directory. This directory
          contains the configuration files for Salt  master  and  minions.
          The default location on most systems is /etc/salt.

   Target Selection
   The  default matching that Salt utilizes is shell-style globbing around
   the                  minion                   id.                   See
   https://docs.python.org/2/library/fnmatch.html#module-fnmatch.

   -E, --pcre
          The  target  expression  will  be  interpreted as a PCRE regular
          expression rather than a shell glob.

   Logging Options
   Logging  options  which  override   any   settings   defined   on   the
   configuration files.

   -l LOG_LEVEL, --log-level=LOG_LEVEL
          Console  logging  log  level. One of all, garbage, trace, debug,
          info, warning, error, quiet. Default: warning.

   --log-file=LOG_FILE
          Log file path. Default: /var/log/salt/ssh.

   --log-file-level=LOG_LEVEL_LOGFILE
          Logfile logging log level. One of all,  garbage,  trace,  debug,
          info, warning, error, quiet. Default: warning.

   Output Options
   --out  Pass  in an alternative outputter to display the return of data.
          This outputter can be any of the available outputters:
             grains, highstate, json, key,  overstatestage,  pprint,  raw,
             txt, yaml

          Some  outputters  are  formatted  only  for  data  returned from
          specific functions; for instance, the grains outputter will  not
          work for non-grains data.

          If  an  outputter  is used that does not support the data passed
          into it, then Salt will fall back on the  pprint  outputter  and
          display the return data using the Python pprint standard library
          module.

          NOTE:
             If using --out=json, you will probably want --static as well.
             Without  the  static  option,  you  will  get a separate JSON
             string per minion which makes JSON output invalid as a whole.
             This  is  due to using an iterative outputter. So if you want
             to feed it to a JSON parser, use --static as well.

   --out-indent OUTPUT_INDENT, --output-indent OUTPUT_INDENT
          Print the output indented  by  the  provided  value  in  spaces.
          Negative   values   disable   indentation.  Only  applicable  in
          outputters that support indentation.

   --out-file=OUTPUT_FILE, --output-file=OUTPUT_FILE
          Write the output to the specified file.

   --no-color
          Disable all colored output

   --force-color
          Force colored output

          NOTE:
             When using colored output the color codes are as follows:

             green denotes success,  red  denotes  failure,  blue  denotes
             changes  and  success  and  yellow  denotes a expected future
             change in configuration.

SEE ALSO

   salt(7) salt-master(1) salt-minion(1)

AUTHOR

   Thomas S. Hatch <[email protected]> and many others,  please  see  the
   Authors file

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.