1growlight(8)                                                      growlight(8)
2
3
4

NAME

6       growlight - Block device and filesystem editor
7

SYNOPSIS

9       growlight   [-h|--help]   [-i|--import]  [-v|--verbose]  [-V|--version]
10       [--disphelp] [-t path|--target=path]
11

DESCRIPTION

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
20       This  page  describes  the fullscreen notcurses(3notcurses) implementa‐
21       tion.  Consult growlight-readline(8) for  a  line-oriented  readline(3)
22       variant.
23

OPTIONS

25       -h|--help: Print a brief usage summary, and exit.
26
27       -i|--import:  Attempt  to assemble aggregates (zpools, MD devices, etc)
28       based on block device scans at startup.
29
30       -v|--verbose: Be more verbose.
31
32       -V|--version: Print version information and exit.
33
34       --disphelp: Display the help subdisplay upon startup.
35
36       --notroot: Force growlight to start without  necessary  privileges  (it
37       will usually refuse to start).
38
39       -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

USAGE

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
57       Press 'q' to exit the program.
58
59       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
68       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
72       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
80       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
88       When running in system installation mode (see --target above), the fol‐
89       lowing commands are also supported:
90
91       • moun't' target
92
93       • unmoun'T' target
94
95       • finalize UEFI with '*'
96
97       • finalize BIOS with '#'
98
99       • finalize fstab with '@'
100

BUGS

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

SEE ALSO

107       mount (2), swapoff (2), swapon (2), umount (2), libblkid (3), notcurses
108       (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       (8),  hdparm  (8),  losetup  (8), lsblk (8), mdadm (8), mkfs (8), mount
111       (8), parted (8), sfdisk (8), umount (8), zfs (8), zpool (8)
112

AUTHORS

114       nick black <nickblack@linux.com>.
115
116
117
118                                    v1.2.32                       growlight(8)
Impressum