man/generated/machinery.1.html in machinery-tool-1.6.0 vs man/generated/machinery.1.html in machinery-tool-1.7.0

- old
+ new

@@ -235,28 +235,10 @@ scope to <code>packages</code>. This will output only the requested information.</p> <p>Machinery supports the following scopes:</p> <ul> -<li><p>changed-managed-files</p> - -<p>Contains the names and contents of all non-configuration files which have -been changed compared to the files in the package. A file change is reported -if its content or its attributes like Linux permission bits or ownership -have changed.</p></li> -<li><p>config-files</p> - -<p>Contains all configuration files which have been changed since they were -installed. -Configuration files are all those files which are marked as such in the -package which has installed them. A configuration file change is reported -if its content or its attributes like Linux permission bits or ownership -have changed.</p></li> -<li><p>groups</p> - -<p>Contains information about the system groups such as group attributes and the -list of group members.</p></li> <li><p>os</p> <p>Contains information about the operating system, name, version, and architecture of the inspected system.</p></li> <li><p>packages</p> @@ -291,20 +273,43 @@ <li><p>A numeric value for a priority. The priority of a repository is compared to the priorities of all other activated repositories. Values can range from 1 (highest) to 99 (lowest, default).</p></li> </ul> </li> +<li><p>users</p> + +<p>Contains information about the system users including user and group ids, +login information, such as password hashes and - if available - additional +password properties.</p></li> +<li><p>groups</p> + +<p>Contains information about the system groups such as group attributes and the +list of group members.</p></li> <li><p>services</p> <p>Services are applications running in the background doing continuous work or waiting for requests to do work. The scope determines which services are configured to be started in which runlevel. It uses the <code>chkconfig</code> command to obtain that information. The xinetd services that are also displayed by <code>chkconfig</code> are switched on/off by editing config files and are ignored in this context.</p></li> -<li><p>unmanaged-files</p> +<li><p>config_files</p> +<p>Contains all configuration files which have been changed since they were +installed. +Configuration files are all those files which are marked as such in the +package which has installed them. A configuration file change is reported +if its content or its attributes like Linux permission bits or ownership +have changed.</p></li> +<li><p>changed_managed_files</p> + +<p>Contains the names and contents of all non-configuration files which have +been changed compared to the files in the package. A file change is reported +if its content or its attributes like Linux permission bits or ownership +have changed.</p></li> +<li><p>unmanaged_files</p> + <p>Contains the names and contents of all files which are not part of any RPM package. The list of unmanaged files contains only plain files and directories. Special files like device nodes, named pipes and Unix domain sockets are ignored. The directories <code>/tmp</code>, <code>/var/tmp</code>, <code>/.snapshots/</code>, <code>/var/run</code> and special mounts like procfs and sysfs are ignored, too. @@ -315,15 +320,10 @@ extracted during inspection.</p> <p>Using the <code>--extract-unmanaged-files</code> option, the files are transferred from the system and stored in the system description. Depending on the content of the inspected system, the amount of data stored may be huge.</p></li> -<li><p>users</p> - -<p>Contains information about the system users including user and group ids, -login information, such as password hashes and - if available - additional -password properties.</p></li> </ul> <h3 id="System-Description">System Description</h3> @@ -465,22 +465,13 @@ <h3 id="BUILD-SUPPORT-MATRIX">BUILD SUPPORT MATRIX</h3> <p>Machinery only supports building x86_64 images on x86_64 systems.</p> -<p>The following combinations of build hosts and targets are supported:</p> +<p>To see the list of supported combinations of build hosts and targets run +<code>machinery build --help</code>.</p> -<ul> -<li><p>SUSE Linux Enterprise 12</p> - -<p>Can build SUSE Linux Enterprise 12</p></li> -<li><p>openSUSE 13.1</p> - -<p>Can build SUSE Linux Enterprise 11 and openSUSE 13.1</p></li> -</ul> - - <h3 id="EXAMPLES">EXAMPLES</h3> <ul> <li><p>To build an image from the system description named "tux" and to save the image under the <code>/tmp/tux/</code> directory:</p> @@ -848,10 +839,14 @@ <dt><code>-n NAME</code>, <code>--name=NAME</code> (optional)</dt><dd><p>Store the system description under the specified name.</p></dd> <dt><code>-s SCOPE</code>, <code>--scope=SCOPE</code> (optional)</dt><dd><p>Inspect system for specified scope. See the <a href="#Scopes" data-bare-link="true">Scope section</a> for more information.</p></dd> <dt><code>-e SCOPE</code>, <code>--exclude-scope=EXCLUDE-SCOPE</code> (optional)</dt><dd><p>Inspect system for all scopes except the specified scope. See the <a href="#Scopes" data-bare-link="true">Scope section</a> for more information.</p></dd> +<dt><code>-r USER</code>, <code>--remote-user=USER</code> (optional)</dt><dd><p>Defines the user which is used to access the inspected system via SSH. +This user needs to be allowed to run certain commands using sudo (see +PREREQUISITES for more information). +To change the default-user use <code>machinery config remote-user USER</code></p></dd> <dt><code>-x</code>, <code>--extract-files</code> (optional)</dt><dd><p>Extract changed configuration and unmanaged files from the inspected system. Shortcut for the combination of <code>--extract-changed-config-files</code>, <code>--extract-unmanaged-files</code>, and <code>--extract-changed-managed-files</code></p></dd> <dt><code>--extract-changed-config-files</code> (optional)</dt><dd><p>Extract changed configuration files from the inspected system.</p></dd> <dt><code>--extract-unmanaged-files</code> (optional)</dt><dd><p>Extract unmanaged files from the inspected system.</p></dd> @@ -892,10 +887,14 @@ <li><code>sed</code></li> <li><code>find</code></li> <li><code>tar</code></li> </ul> </li> +<li><p>When inspecting as non-root the user has to have the following command +whitelist given in the sudoers file:</p> + +<p>machinery ALL=(ALL) NOPASSWD: /usr/bin/find,/usr/bin/cat,/usr/bin/rsync,/bin/rpm -V *,/bin/tar --create *</p></li> </ul> <h3 id="EXAMPLES">EXAMPLES</h3> @@ -910,10 +909,13 @@ <p># <code>machinery</code> inspect --scope="packages" localhost</p></li> <li><p>Extracts changed managed files and saves them in the same way as changed configuration files are saved:</p> <p>$ <code>machinery</code> inspect --scope=changed-managed-files --extract-files myhost</p></li> +<li><p>To inspect the remote system <code>myhost</code> with the user <code>machinery</code>:</p> + +<p>$ <code>machinery</code> inspect --remote-user machinery myhost</p></li> </ul> <h2 id="list-List-System-Descriptions">list — List System Descriptions</h2> @@ -1165,10 +1167,10 @@ <p>Copyright (c) 2013-2015 <a href="http://www.suse.com">SUSE LLC</a></p> <ol class='man-decor man-foot man foot'> <li class='tl'></li> - <li class='tc'>April 2015</li> + <li class='tc'>May 2015</li> <li class='tr'>machinery(1)</li> </ol> </div> </body>