Files
s390-tools/zdev/src/chzdev_usage.txt
Peter Oberparleiter fe68ec513d zdev: Add support for handling auto-configuration data
Auto-configuration is the name of a new configuration target that is
supported by chzdev and lszdev besides the existing active and
persistent configuration targets. Directives created in this new
configuration are stored as udev rules in the /run/udev/rules.d
directory.

Auto-configuration directives are only in effect if there are no
directives for the same device in the user-provided persistent
configuration. This allows users to override auto-configuration
directives if necessary.

Due to the volatile nature of the /run directory, auto-configuration
directives are cleared on reboot. Therefore mechanisms that generate
auto-configuration directives must recreate them on every boot.

The lszdev tool displays auto-configuration data both in list view
as well as in detail view. Users can specify the new option --auto-conf
to only show data from this configuration target.

Mechanisms that generate automated configuration directives can use
chzdev together with the --auto-conf option to create the corresponding
udev rules.

Note: This change does not include a mechanism that generates
      auto-configuration directives.

Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
2018-06-08 15:03:30 +02:00

61 lines
2.8 KiB
Plaintext

Usage: chzdev TYPE DEVICE [SELECTION] [SETTINGS] [ACTION] [OPTIONS]
Use chzdev to manage the configuration of z Systems specific devices in either:
- active configuration (running system), or
- persistent configuration (configuration files)
Actions apply to both configurations unless specified otherwise.
TYPE
Device type to which this command applies. Use --list-types to display
supported types.
DEVICE
ID Select single device by ID, e.g. 0.0.1234
FROM-TO Select range of devices between FROM and TO
DEV1,DEV2,... Select list of devices or device ranges
SELECTION
--all Select all existing and configured devices
--configured Select devices with a persistent configuration
--existing Select devices found in the active configuration
--online/--offline Select devices that are online/offline
--failed Select devices that are not functioning correctly
--by-path PATH Select device providing file system path, e.g. /usr
--by-node NODE Select device providing device node, e.g. /dev/sda
--by-interface NAME Select device providing network interface, e.g. eth0
--by-attrib KEY=VALUE Select devices with specified attribute value
SETTINGS
Specifications in the form ATTRIB=VALUE used to modify device or device type
settings. Use --list-attributes (also with --type) to list available
attributes.
ACTIONS
-e, --enable Enable device
-d, --disable Disable device
-l, --list-attributes List attributes
-L, --list-types List supported device types
-H, --help-attribute Show detailed help on specified attribute
--export FILENAME Export configuration data to file
--import FILENAME Import configuration data from file
--apply Apply persistent settings to active configuration
-h, --help Print usage information, then exit
-v, --version Print version information, then exit
OPTIONS
-a, --active Apply changes to active configuration only
-p, --persistent Apply changes to persistent configuration only
-t, --type Apply changes to device type
-r, --remove ATTRIB Remove setting for specified attribute
-R, --remove-all Remove settings for all attributes
-f, --force Override safety checks
-y, --yes Answer all confirmation questions with 'yes'
--no-root-update Skip root device update
--dry-run Display changes without applying
--base PATH Use PATH as base for accessing files
--no-settle Do not wait for udev to settle
--auto-conf Apply changes to auto-configuration only
-V, --verbose Print additional run-time information
-q, --quiet Print only minimal run-time information