1 33bf1ca4 2023-04-08 benni # lsblk for OpenBSD
 2 1abb1c5c 2023-05-02 benni This project aims to implement a clone of lsblk(8) for OpenBSD.
 3 33bf1ca4 2023-04-08 benni 
 4 1abb1c5c 2023-05-02 benni ## Install
 5 1abb1c5c 2023-05-02 benni ``` sh
 6 1abb1c5c 2023-05-02 benni # Clone the repo.
 7 1abb1c5c 2023-05-02 benni git clone git://stuerz.xyz/openbsd/lsblk
 8 1abb1c5c 2023-05-02 benni 
 9 1abb1c5c 2023-05-02 benni # Build & Install lsblk(8).
10 1abb1c5c 2023-05-02 benni make && doas make install
11 1abb1c5c 2023-05-02 benni 
12 1abb1c5c 2023-05-02 benni # Optional: Make non-roots be able to run lsblk(8).
13 1abb1c5c 2023-05-02 benni doas make unroot
14 1abb1c5c 2023-05-02 benni ```
15 1abb1c5c 2023-05-02 benni 
16 33bf1ca4 2023-04-08 benni ## Quirks
17 33bf1ca4 2023-04-08 benni - It requires root privileges
18 fa7b2359 2023-05-01 benni   Workaround: `make unroot`
19 33bf1ca4 2023-04-08 benni 
20 33bf1ca4 2023-04-08 benni ## TODO
21 1115ad3a 2023-05-05 benni - [x] `lsblk sd0`
22 5691dc7b 2023-05-05 benni - [ ] `lsblk sd0a`
23 0c422a5b 2023-05-05 benni - [ ] `lsblk -f duid,size`
24 7c38b724 2023-05-15 benni - [x] Don't use manual padding.
25 185836d0 2023-05-15 benni - [x] Support disks that have more than 2 letters, like `vnd0`
26 4d8e470c 2023-05-15 benni - [x] Sort drives by name
27 191a6a0e 2023-05-04 benni - [ ] Add an option to make the output script-friendly (like -c for CSV).
28 1678d261 2023-05-15 benni - [x] Maybe: Display the child device of a RAID partition
29 1115ad3a 2023-05-05 benni - [x] Show the DUID
30 1678d261 2023-05-15 benni - [ ] Explain the exact meaning of every field in lsblk.8
31 4520a881 2023-09-01 benni 
32 4520a881 2023-09-01 benni ## Contributing
33 4520a881 2023-09-01 benni If you find any bugs or have suggestions/patches,
34 4520a881 2023-09-01 benni please contact me at <benni@stuerz.xyz>.