dasd_configure(8)

πŸ“¦ version 2.44.1, in opensuse-leap 16.0

πŸ’… NAME

dasd_configure β€” configures or deconfigures a Direct Access Storage Device (DASD) volume. That’s the whole name, bestie, and yes: this is the dasd_configure(8) page from the System Manager’s Manual. She’s here to make DASD volume wrangling make sense πŸ’–


✨ SYNOPSIS ✨

dasd_configure [-f -t dasd_type ] ccwid online [use_diag]

🌸 DESCRIPTION 🌸

okay so dasd_configure is intended to make it easy to persistently add and remove DASD volumes. That’s the main character job. In addition to bringing the volume online or offline, it will also create or delete the necessary udev rules for the volume. slay, honestly ✨


πŸŽ€ PARAMETERS πŸŽ€

  • -f β€” Force creation of udev rules, do not check values in /sys.
  • -t β€” Must be either dasd-eckd or dasd-fba. Must be provided if -f is used.
  • ccwid β€” The device number of the DASD volume. Takes the form x.y.ssss where:
    • x is always 0 until IBM creates something that uses that number.
    • y is the subchannel set ID (SSID). Most often this is 0, but it could be non-zero.
    • ssss is the four digit device address of the subchannel, in hexidecimal, with leading zeros. If entered in upper/mixed case, this is automatically converted to lower case.
  • online β€” Either a literal 1 to bring the volume online or a literal 0 to take it offline.
  • use_diag β€” Either a literal 1 to use the DIAG driver for this device, or a literal 0 to use the "normal" driver.

πŸ¦‹ FILES πŸ¦‹

Please see the documentation of chzdev. That’s where the file tea lives 🫢


πŸ“ ENVIRONMENT πŸ“

  • DEBUG β€” If set to "yes" some minimal debugging information is output during execution.

πŸ’œ DIAGNOSTICS πŸ’œ

Messages and return codes are determined by the chzdev command. Except for:

  • Device ${CCW_CHAN_ID} is unformatted β€” The DASD volume was brought online, but it has not been formatted with dasdfmt. This condition is really only important for YaST to determine if it should prompt the user to decide if they want to format it or not at that point. Return code 8 is set.

If environment variable DEBUG is set to "yes," it shows the command line of the invoked chzdev. Additionally, the following messages may be issued on stdout:

  • DASD ${CCW_CHAN_ID} did not come online. β€” The DASD volume did not come online within the waiting time. Could not check if the DASD is formatted (see above). Return code 17 is set.
🫢 tiny heads-up, bestie: those messages and return codes are part of the whole diagnostic vibe β€” don’t ignore them.

πŸ”₯ BUGS πŸ”₯

Gotta be some, I’m sure. If you find one, please open a bug report. fr fr, the maintainers wanna know πŸ’€


okay that’s the whole page, bestie πŸŽ€ this cutie came from s390-tools and is dated February 2013. mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from