1growlight(8) growlight(8)
2
6 growlight - Block device and filesystem editor
7
9 growlight [-h|--help] [-i|--import] [-v|--verbose] [-V|--version]
10 [--disphelp] [-t path|--target=path]
11
13 growlight detects and describes disk pools, block devices, partition
14 tables, and partitions. It can partition devices, manipulate ZFS, MD,
15 DM, LVM and hardware RAID virtual devices, and prepare an fstab file
16 for using the devices to boot or in a chroot, and is fully aware of
17 variable sector sizes, GPT, and UEFI. growlight facilitates use of
18 UUID/WWN- and HBA-based identification of block devices.
19 This page describes the fullscreen notcurses(3notcurses) implementa‐
21 tion. Consult growlight-readline(8) for a line-oriented readline(3)
22 variant.
23
25 -h|--help: Print a brief usage summary, and exit.
26 -i|--import: Attempt to assemble aggregates (zpools, MD devices, etc)
28 based on block device scans at startup.
29 -v|--verbose: Be more verbose.
31 -V|--version: Print version information and exit.
33 --disphelp: Display the help subdisplay upon startup.
35 --notroot: Force growlight to start without necessary privileges (it
37 will usually refuse to start).
38 -t path|--target=path: Run in system installation mode, using path as
40 the temporary mountpoint for the target's root filesystem. "map" com‐
41 mands will populate the hierarchy rooted at this mountpoint. System
42 installation mode can also be entered at run time with the "target"
43 command. The "map" command will not result in active mounts unless
44 growlight is operating in system installation mode (they will merely be
45 used to construct target fstab output). Once system installation mode
46 is entered, growlight will return 0 only as a result of a successful
47 invocation of the "target finalize" command. path must exist at the
48 time of its specification.
49
51 Press 'H' or 'F1' to toggle a help display. This display lists all
52 available commands; commands which don't make sense at the moment are
53 grayed out. Most of these commands are also available from the menu at
54 the top of the screen. Press 'Alt' plus the underlined shortcut key to
55 open a section of the menu, or click on it with a mouse.
56 Press 'q' to exit the program.
58 The display is hierarchal, with block devices being collected under
60 their respective storage adapters. In addition to various physical
61 adapters, a "virtual" adapter is provided for e.g. aggregated devices.
62 Move among the adapters with Page Up and Page Down. Move among the
63 block devices of an adapter with up and down; move among the partitions
64 of a block device with left and right. Vi keys ('h'/'j'/'k'/'l') are
65 also supported. Search with '/'; this search will be applied to all
66 metadata.
67 The 'G'rowlight menu allows toggling various subscreens, including the
69 help, recent diagnostics, mount points, and a details view. Only one
70 subscreen can be up at a time.
71 The 'B'lockdevs menu allows you to 'm'ake a partition table (only if
73 the selected block device doesn't already have one), 'r'emove a parti‐
74 tion table (assuming one is present), 'W'ipe a Master Boot Record
75 (overwriting it with zeroes), perform a 'B'ad block check, cre'A'te a
76 new aggregate block device (e.g. an mdadm array or ZFS zpool), modify
77 an existing aggregate with 'z', unbind an aggregate with 'Z', or set
78 u'p' a loop device.
79 The 'P'artitions menu allows you to make a 'n'ew partition (in empty,
81 unallocated space, on a block device with an existing partition table),
82 'd'elete a partition, 's'et partition attributes, 'M'ake a filesystem,
83 'F'sck a filesystem, 'w'ipe a filesystem, name a filesystem 'L'abel or
84 name, set a filesystem's 'U'uid, m'o'unt a filesystem, or unm'O'unt a
85 filesystem. Most of these latter commands can also be applied to swap
86 devices.
87 When running in system installation mode (see --target above), the fol‐
89 lowing commands are also supported:
90 • moun't' target
92 • unmoun'T' target
94 • finalize UEFI with '*'
96 • finalize BIOS with '#'
98 • finalize fstab with '@'
100
102 Pedantic collections of ambiguous identifiers (for instance, if a label
103 equals another device's /dev/ name) will lead to questionable results.
104 This ought be fixed.
105
107 mount (2), swapoff (2), swapon (2), umount (2), libblkid (3), notcurses
108 [1m(3), fstab (5), proc (5), inotify (7), udev (7), blkid(8),, dmraid(8),
109 dmsetup (8), growlight-readline(8), grub-install (8), grub-mkdevicemap
110 [1m(8), hdparm (8), losetup (8), lsblk (8), mdadm (8), mkfs (8), mount
111 [1m(8), parted (8), sfdisk (8), umount (8), zfs (8), zpool (8)
112
114 nick black <nickblack@linux.com>.
115 v1.2.32 growlight(8)