Εγχειρίδια για τη γραμμή εντολών

Man » Online εγχειρίδιο lsblk - λεπτομερής διαδικτυακή τεκμηρίωση για τη σελίδα man του lsblk

🌍
lsblk - εμφάνιση των διαθέσιμων συσκευών μπλοκ

ΣΥΝΤΑΞΗ

lsblk [επιλογές] [συσκευή...]

ΠΕΡΙΓΡΑΦΗ

Η lsblk εμφανίζει πληροφορίες για όλες τις διαθέσιμες ή τις καθορισμένες συσκευές μπλοκ. Η εντολή lsblk
διαβάζει το σύστημα αρχείων sysfs και τη βάση δεδομένων udev για να συλλέξει πληροφορίες. Εάν η βάση δεδομένων udev δεν είναι διαθέσιμη ή
η lsblk έχει μεταγλωττιστεί χωρίς υποστήριξη udev, τότε προσπαθεί να διαβάσει τις ΕΤΙΚΕΤΕΣ, τα UUID και τους τύπους συστημάτων αρχείων
από τη συσκευή μπλοκ. Σε αυτήν την περίπτωση, απαιτούνται δικαιώματα root.

Από προεπιλογή, η εντολή εκτυπώνει όλες τις συσκευές μπλοκ (εκτός από τις μνήμες RAM) σε μια δενδρική μορφή. Η ίδια συσκευή μπορεί να επαναληφθεί στο δέντρο εάν σχετίζεται με άλλες συσκευές. Η επιλογή --merge συνιστάται για πιο σύνθετες ρυθμίσεις, ώστε να ομαδοποιηθούν οι συσκευές και να περιγραφούν οι σύνθετες σχέσεις N:M.

Η δενδρική έξοδος (ή ο πίνακας children[] στην έξοδο JSON) είναι ενεργοποιημένη μόνο εάν η στήλη NAME είναι παρούσα στην έξοδο ή όταν χρησιμοποιείται η επιλογή γραμμής εντολών --tree. Δείτε επίσης τις επιλογές --nodeps και --list για τον έλεγχο της μορφοποίησης του δέντρου.

Η προεπιλεγμένη έξοδος, καθώς και η προεπιλεγμένη έξοδος από επιλογές όπως --fs και --topology, υπόκεινται σε αλλαγές. Επομένως, όποτε είναι δυνατόν, θα πρέπει να αποφεύγετε τη χρήση της προεπιλεγμένης εξόδου στα σενάριά σας. Ορίστε πάντα ρητά τις αναμενόμενες στήλες χρησιμοποιώντας το --output columns-list και το --list σε περιβάλλοντα όπου απαιτείται σταθερή έξοδος.

Χρησιμοποιήστε την εντολή lsblk --list-columns για να λάβετε μια λίστα με όλες τις διαθέσιμες στήλες.

Σημειώστε ότι η lsblk μπορεί να εκτελεστεί σε μια χρονική στιγμή που η udev δεν διαθέτει ακόμη όλες τις πληροφορίες για τις πρόσφατα προστιθέμενες ή τροποποιημένες συσκευές. Σε αυτήν την περίπτωση, συνιστάται να χρησιμοποιήσετε την εντολή udevadm settle πριν από την lsblk για να συγχρονιστείτε με την udev.

Η σχέση μεταξύ των συσκευών μπλοκ και των συστημάτων αρχείων δεν είναι πάντα ένας προς ένα. Το σύστημα αρχείων μπορεί να χρησιμοποιεί περισσότερες συσκευές μπλοκ ή το ίδιο σύστημα αρχείων μπορεί να είναι προσβάσιμο από περισσότερα μονοπάτια. Αυτός είναι ο λόγος για τον οποίο η lsblk παρέχει τις στήλες MOUNTPOINT και MOUNTPOINTS (πληθυντικός). Η στήλη MOUNTPOINT εμφανίζει μόνο ένα σημείο προσάρτησης (συνήθως την τελευταία φορά που προσαρτήθηκε το σύστημα αρχείων) και η στήλη MOUNTPOINTS εμφανίζει σε μια πολυσυγγραφική κελιού όλα τα σημεία προσάρτησης που σχετίζονται με τη συσκευή.

ΕΠΙΛΟΓΕΣ

-A, --noempty
Μην εκτυπώνετε τις κενές συσκευές.

-a, --all
Απενεργοποιήστε όλα τα ενσωματωμένα φίλτρα και εμφανίστε όλες τις κενές συσκευές και τις συσκευές μνήμης RAM.

-b, --bytes
Εκτυπώστε τα μεγέθη σε byte αντί σε μια μορφή φιλική προς τον χρήστη.

Από προεπιλογή, η μονάδα, στην οποία εκφράζονται τα μεγέθη, είναι το byte και τα προθέματα μονάδων είναι σε δύναμη του 2^10
(1024). Οι συντομογραφίες των συμβόλων εμφανίζονται περικομμένες προκειμένου να επιτευχθεί καλύτερη
αναγνωσιμότητα, εμφανίζοντας μόνο το πρώτο γράμμα αυτών. παραδείγματα: "1 KiB" και "1 MiB"
εμφανίζονται αντίστοιχα ως "1 K" και "1 M", παραλείποντας σκόπιμα την αναφορά "iB", η οποία
είναι μέρος αυτών των συντομογραφιών.

-H, --list-columns
Εμφανίζει τις διαθέσιμες στήλες, χρησιμοποιήστε το με τις επιλογές --json ή --raw για να λάβετε την έξοδο σε μορφή κατάλληλη για μηχανική επεξεργασία.

-D, --discard
Εμφανίζει πληροφορίες σχετικά με τις δυνατότητες διαγραφής (TRIM, UNMAP) για κάθε συσκευή.

-d, --nodeps
Δεν εμφανίζει τις συσκευές που χρησιμοποιούνται από άλλες συσκευές ή τις δευτερεύουσες συσκευές. Για παράδειγμα, η εντολή `lsblk --nodeps /dev/sda` εμφανίζει πληροφορίες μόνο για τη συσκευή `sda`.

-E, --dedup column
Χρησιμοποιεί μια στήλη ως κλειδί αποενοποίησης για την αποενοποίηση της εξόδου της δενδρικής δομής. Εάν το κλειδί δεν είναι διαθέσιμο για τη συσκευή ή εάν η συσκευή είναι ένα διαμέρισμα και η γονική συσκευή δίσκου παρέχει το ίδιο κλειδί, τότε η συσκευή εμφανίζεται πάντα.

Η συνήθης περίπτωση χρήσης είναι η αποενοποίηση της εξόδου σε ένα σύστημα με πολλές διαδρομές πρόσβασης στις συσκευές, για παράδειγμα με την επιλογή `-E WWN`.

-e, --exclude list
Εξαιρεί τις συσκευές που καθορίζονται από τη λίστα διαχωρισμένη με κόμματα των κύριων αριθμών συσκευών. Σημειώστε ότι οι δίσκοι RAM (κύριος=1) εξαιρούνται από προεπιλογή εάν δεν καθοριστεί η επιλογή `--all`. Το φίλτρο εφαρμόζεται μόνο στις συσκευές ανώτατου επιπέδου. Αυτό μπορεί να είναι παραπλανητικό για τη μορφή εξόδου `--list` όπου η ιεραρχία των συσκευών δεν είναι προφανής.

-f, --fs
Εμφανίζει πληροφορίες σχετικά με τα συστήματα αρχείων. Αυτή η επιλογή είναι ισοδύναμη με την `-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS`. Οι έγκυρες πληροφορίες σχετικά με τα συστήματα αρχείων και τις διατάξεις RAID παρέχονται από την εντολή `blkid(8)`.

--hyperlink[=mode]
Εμφανίζει τις διαδρομές των σημείων τοποθέτησης ως υπερσυνδέσμους στο τερματικό. Η λειτουργία μπορεί να οριστεί σε "always", "never" ή "auto". Η προαιρετική παράμετρος `when` μπορεί να οριστεί σε "auto", "never" ή "always". Εάν η παράμετρος `when` παραλειφθεί, θα έχει προεπιλεγμένη τιμή "auto". Η ρύθμιση "auto" σημαίνει ότι οι υπερσύνδεσμοι θα χρησιμοποιούνται μόνο εάν η έξοδος είναι σε τερματικό.

-I, --include list
Ενσωματώνει τις συσκευές που καθορίζονται από τη λίστα διαχωρισμένη με κόμματα των κύριων αριθμών συσκευών. Το φίλτρο εφαρμόζεται μόνο στις συσκευές ανώτατου επιπέδου. Αυτό μπορεί να είναι παραπλανητικό για τη μορφή εξόδου `--list` όπου η ιεραρχία των συσκευών δεν είναι προφανής.

-i, --ascii
Χρησιμοποιεί χαρακτήρες ASCII για τη διαμόρφωση του δέντρου.

-J, --json
Χρησιμοποιεί μορφή εξόδου JSON. Συνιστάται ιδιαίτερα να χρησιμοποιείτε τις επιλογές `--output` και `--tree`, εάν χρειάζεται. Σημειώστε ότι το `children[]` χρησιμοποιείται μόνο εάν χρησιμοποιείται η στήλη `NAME` ή η επιλογή `--tree`.

-l, --list
Παράγει έξοδο σε μορφή λίστας. Η έξοδος δεν παρέχει πληροφορίες σχετικά με τις σχέσεις μεταξύ των συσκευών και από την έκδοση 2.34, κάθε συσκευή εμφανίζεται μόνο μία φορά, εκτός εάν καθοριστούν οι επιλογές `--pairs` ή `--raw` (οι μορφές εξόδου κατάλληλες για ανάλυση διατηρούνται με τρόπο συμβατό με προηγούμενες εκδόσεις).

-M, --merge
Ομαδοποιεί τους γονείς των υποδέντρων για να παρέχει πιο ευανάγνωστη έξοδο για διατάξεις RAID και συσκευές με πολλές διαδρομές πρόσβασης. Απαιτείται η μορφή εξόδου σε μορφή δέντρου.

-m, --perms
Εμφανίζει πληροφορίες σχετικά με τον ιδιοκτήτη, την ομάδα και τη λειτουργία της συσκευής. Αυτή η επιλογή είναι ισοδύναμη με την `-o NAME,SIZE,OWNER,GROUP,MODE`.

-N, --nvme
Εμφανίζει πληροφορίες μόνο για τις συσκευές NVMe.

-v, --virtio
Εμφανίζει πληροφορίες μόνο για τις συσκευές virtio.

-n, --noheadings
Δεν εμφανίζει μια γραμμή κεφαλίδας.

-o, --output list
Καθορίζει ποιες στήλες εξόδου θα εμφανιστούν. Χρησιμοποιήστε την επιλογή `--list-columns` για να λάβετε μια λίστα με όλες τις υποστηριζόμενες στήλες. Οι στήλες μπορεί να επηρεάσουν την έξοδο σε μορφή δέντρου. Η προεπιλογή είναι η χρήση της μορφής δέντρου για τη στήλη `NAME` (δείτε επίσης την επιλογή `--tree`).

Η προεπιλεγμένη λίστα στηλών μπορεί να επεκταθεί εάν καθοριστεί μια λίστα στη μορφή +list (π.χ. lsblk -o +UUID).

-O, --output-all

Εμφάνιση όλων των διαθέσιμων στηλών.

-P, --pairs

Δημιουργία εξόδου με τη μορφή ζευγών κλειδιού="τιμή". Οι γραμμές εξόδου εξακολουθούν να είναι ταξινομημένες σύμφωνα με τις εξαρτήσεις. Όλοι οι δυνητικά επικίνδυνοι χαρακτήρες τιμών κωδικοποιούνται σε δεκαεξαδική μορφή (\x<code>). Δείτε επίσης την επιλογή --shell.

-P, --paths

Εκτύπωση των πλήρων διαδρομών συσκευών.

-Q, --filter expr

Εκτύπωση μόνο των συσκευών που πληρούν τις συνθήκες που καθορίζονται από το expr. Το φίλτρο αξιολογείται πριν από τη συλλογή δεδομένων για όλες τις στήλες εξόδου από το lsblk. Μόνο τα απαραίτητα δεδομένα για την αργή αξιολόγηση της έκφρασης ανακτώνται από το σύστημα. Αυτή η προσέγγιση μπορεί να βελτιώσει την απόδοση σε σύγκριση με το φιλτράρισμα μετά την επεξεργασία, όπως γίνεται συνήθως από εργαλεία όπως το grep(1).

Αυτή η δυνατότητα είναι ΠΕΙΡΑΜΑΤΙΚΗ. Δείτε επίσης scols-filter(5). Για παράδειγμα, για να εξαιρέσετε τα sda και sdb, αλλά να εκτυπώσετε τα
υπόλοιπα ('!~' είναι ένας τελεστής αρνητικής αντιστοίχισης κανονικής έκφρασης):

lsblk --filter 'NAME !~ "sd[ab]"'

--highlight expr

Χρωματισμός γραμμών που ταιριάζουν με την έκφραση. Αυτή η δυνατότητα είναι ΠΕΙΡΑΜΑΤΙΚΗ. Δείτε επίσης scols-filter(5).

--ct name [: param [: function ]]

Ορισμός ενός προσαρμοσμένου μετρητή. Οι μετρητές εκτυπώνονται μετά την τυπική έξοδο. Το name είναι το προσαρμοσμένο όνομα του μετρητή, το προαιρετικό param είναι το όνομα της στήλης που θα χρησιμοποιηθεί για τον μετρητή και η προαιρετική συνάρτηση καθορίζει τη συνάρτηση συγκέντρωσης, οι υποστηριζόμενες συνάρσεις είναι: count, min, max ή sum. Η προεπιλογή είναι count.

Εάν το param δεν καθοριστεί, τότε ο μετρητής μετρά τον αριθμό των γραμμών. Αυτή η δυνατότητα είναι
ΠΕΙΡΑΜΑΤΙΚΗ. Δείτε επίσης --ct-filter.

Για παράδειγμα, το --ct MyCounter:SIZE:sum θα υπολογίσει το άθροισμα για το SIZE από όλες τις γραμμές. και για να
μετρήσετε τον αριθμό των δίσκων SATA, είναι δυνατό να χρησιμοποιήσετε:

lsblk --ct-filter 'TYPE=="disk" && TRAN=="sata"' --ct "Αριθμός συσκευών SATA"

--ct-filter expr

Ορισμός περιορισμού για τον επόμενο μετρητή. Αυτή η δυνατότητα είναι ΠΕΙΡΑΜΑΤΙΚΗ. Δείτε επίσης --ct και scols-filter(5). Για παράδειγμα, για να συγκεντρωθούν μεγέθη κατά τύπο συσκευής:

lsblk --ct-filter 'TYPE=="part"' --ct Partitions:SIZE:sum \
--ct-filter 'TYPE=="disk"' --ct WholeDisks:SIZE:sum

-r, --raw

Δημιουργία εξόδου σε μορφή raw. Οι γραμμές εξόδου εξακολουθούν να είναι ταξινομημένες σύμφωνα με τις εξαρτήσεις. Όλοι οι δυνητικά επικίνδυνοι χαρακτήρες κωδικοποιούνται σε δεκαεξαδική μορφή (\x<code>) στις στήλες NAME, KNAME, LABEL, PARTLABEL και MOUNTPOINT.

-S, --scsi

Εμφάνιση πληροφοριών μόνο για τις συσκευές SCSI. Όλες οι διαμερίσεις, οι δευτερεύουσες συσκευές και οι συσκευές βάσης αγνοούνται.

-s, --inverse

Εκτύπωση των εξαρτήσεων σε αντίστροφη σειρά. Εάν ζητηθεί η έξοδος --list, οι γραμμές εξακολουθούν να είναι ταξινομημένες σύμφωνα με τις εξαρτήσεις.

-T, --tree[=column]

Επιβολή μορφής εξόδου σε μορφή δένδρου. Εάν καθοριστεί η στήλη, εκτυπώνεται ένα δένδρο στη στήλη. Η προεπιλογή είναι η στήλη NAME.

-t, --topology

Εμφάνιση πληροφοριών σχετικά με την τοπολογία των συσκευών μπλοκ. Αυτή η επιλογή είναι ισοδύναμη με


-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME.

-w, --width number

Καθορίζει το πλάτος εξόδου ως αριθμός χαρακτήρων. Η προεπιλογή είναι ο αριθμός των στηλών του τερματικού και, εάν δεν εκτελείται σε τερματικό, τότε το πλάτος εξόδου δεν περιορίζεται καθόλου από προεπιλογή. Αυτή η επιλογή αναγκάζει επίσης το lsblk να υποθέτει ότι οι χαρακτήρες ελέγχου τερματικού και οι μη ασφαλείς χαρακτήρες δεν επιτρέπονται. Η αναμενόμενη περίπτωση χρήσης είναι, για παράδειγμα, όταν το lsblk χρησιμοποιείται από την εντολή watch(1).

-x, --sort column

Ταξινομεί τις γραμμές εξόδου κατά στήλη. Αυτή η επιλογή ενεργοποιεί την μορφή εξόδου --list από προεπιλογή. Είναι δυνατό να χρησιμοποιηθεί η επιλογή --tree για να αναγκαστεί μια μορφή εξόδου σαν δέντρο και, στη συνέχεια, οι κλάδοι του δέντρου ταξινομούνται κατά τη στήλη.

-y, --shell

Το όνομα της στήλης θα τροποποιηθεί ώστε να περιέχει μόνο χαρακτήρες που επιτρέπονται για αναγνωριστικά μεταβλητών shell, για παράδειγμα, MIN_IO και FSUSE_PCT αντί για MIN-IO και FSUSE%. Αυτό μπορεί να χρησιμοποιηθεί, για παράδειγμα, με το --pairs. Σημειώστε ότι αυτή η λειτουργία έχει ενεργοποιηθεί αυτόματα για το --pairs στην έκδοση 2.37, αλλά λόγω προβλημάτων συμβατότητας, τώρα είναι απαραίτητο να ζητηθεί αυτή η συμπεριφορά με το --shell.

-z, --zoned

Εμφανίζει τις σχετικές πληροφορίες ζώνης για κάθε συσκευή.

--sysroot directory

Συλλέγει δεδομένα για μια παρουσία Linux διαφορετική από την παρουσία από την οποία εκτελείται η εντολή lsblk. Ο καθορισμένος κατάλογος είναι η ρίζα του συστήματος της παρουσίας Linux που θα επιθεωρηθεί. Οι πραγματικές συσκευές στο στοχευμένο κατάλογο μπορούν να αντικατασταθούν από αρχεία κειμένου με χαρακτηριστικά udev.

--properties-by list

Αυτή η επιλογή καθορίζει τις μεθόδους που χρησιμοποιεί το lsblk για τη συλλογή πληροφοριών σχετικά με τα συστήματα αρχείων και τους πίνακες διαμερισμάτων. Η λίστα είναι μια λίστα μεθόδων που διαχωρίζονται με κόμμα. Η προεπιλεγμένη ρύθμιση είναι "file,udev,blkid". Οι υποστηριζόμενες μέθοδοι είναι:

udev

Διαβάζει δεδομένα από τη βάση δεδομένων udev. Εάν αποτύχει, συνεχίζει στην επόμενη μέθοδο ανίχνευσης.

blkid

Διαβάζει δεδομένα απευθείας από τη συσκευή χρησιμοποιώντας το libblkid. Εάν αποτύχει, συνεχίζει στην επόμενη μέθοδο ανίχνευσης.

file

Διαβάζει δεδομένα από ένα αρχείο. Αυτή η μέθοδος χρησιμοποιείται μόνο εάν έχει καθοριστεί η επιλογή --sysroot. Αυτή η μέθοδος σταματά πάντα την ανίχνευση όταν χρησιμοποιείται.

none

Δεν ανιχνεύει. Αυτή η μέθοδος σταματά πάντα την ανίχνευση.

-h, --help

Εμφανίζει το κείμενο βοήθειας και εξέρχεται.

-V, --version

Εμφανίζει την έκδοση και εξέρχεται.

ΚΑΤΑΣΤΑΣΗ ΕΞΟΔΟΥ

0   επιτυχία

1   αποτυχία

32  καμία από τις καθορισμένες συσκευές δεν βρέθηκε

64  μερικές από τις καθορισμένες συσκευές βρέθηκαν, μερικές όχι

ΠΕΡΙΒΑΛΛΟΝ

LSBLK_DEBUG=all
ενεργοποιεί την έξοδο εντοπισμού σφαλμάτων του lsblk.

LIBBLKID_DEBUG=all
ενεργοποιεί την έξοδο εντοπισμού σφαλμάτων του libblkid.

LIBMOUNT_DEBUG=all
ενεργοποιεί την έξοδο εντοπισμού σφαλμάτων του libmount.

LIBSMARTCOLS_DEBUG=all
ενεργοποιεί την έξοδο εντοπισμού σφαλμάτων του libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on
χρησιμοποιεί ορατούς χαρακτήρες συμπλήρωσης.

ΣΗΜΕΙΩΣΕΙΣ

Για τα διαμερίσματα, ορισμένες πληροφορίες (π.χ., χαρακτηριστικά ουράς) κληρονομούνται από τη μητρική συσκευή.

Η εντολή lsblk πρέπει να μπορεί να αναζητήσει κάθε μπλοκ συσκευής κατά κύριο:δευτερεύον αριθμό, κάτι που γίνεται χρησιμοποιώντας το /sys/dev/block. Αυτός ο κατάλογος sysfs εμφανίστηκε στην έκδοση 2.6.27 του πυρήνα (Οκτώβριος 2008). Σε περίπτωση προβλημάτων με έναν αρκετά νέο πυρήνα, ελέγξτε ότι το CONFIG_SYSFS ήταν ενεργοποιημένο κατά τη διάρκεια της κατασκευής του πυρήνα.


ΣΥΓΓΡΑΦΕΙΣ

Milan Broz <_>, Karel Zak <_>

ΔΕΙΤΕ ΕΠΙΣΗΣ

blkid(8), findmnt(8) ls(1), scols-filter(5)

ΑΝΑΦΟΡΑ ΣΦΑΛΜΑΤΩΝ

Για αναφορές σφαλμάτων, χρησιμοποιήστε το σύστημα παρακολούθησης προβλημάτων [https://github.com/util-linux/util-linux/issues].

ΔΙΑΘΕΣΙΜΟΤΗΤΑ

Η εντολή lsblk αποτελεί μέρος του πακέτου util-linux, το οποίο μπορεί να ληφθεί από το Linux Kernel Archive [https://www.kernel.org/pub/linux/utils/util-linux/].