mirror of
https://github.com/vyos/vyos-documentation.git
synced 2025-12-15 18:12:02 +01:00
bc7512c2c7
* Proofread boot-options.rst * Fix line length Markdown lint errors * Proofread information.rst * Update lastproofread date in information.rst * Updated password-recovery.rst * Proofread upgrade-recovery.rst * Fix line length linting errors * Proofread up to Empty 2+ Disk * Complete proofread of raid.rst * Update upgrade-recovery timeout explanation * Fix header formatting * Update docs/operation/boot-options.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add missing period in raid.rst * Implement Copilot feedback --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Daniil Baturin <daniil@baturin.org>
157 lines
6.4 KiB
ReStructuredText
157 lines
6.4 KiB
ReStructuredText
:lastproofread: 2025-11-19
|
|
|
|
.. _information:
|
|
|
|
******************
|
|
System Information
|
|
******************
|
|
|
|
VyOS features a rich set of operational level commands to retrieve arbitrary
|
|
information about your running system. For more information on the VyOS command
|
|
line interface (CLI), see :ref:`cli`.
|
|
|
|
########
|
|
Hardware
|
|
########
|
|
|
|
.. _hardware_usb:
|
|
|
|
USB
|
|
===
|
|
|
|
In the past, serial interfaces were defined as ``ttySx`` and ``ttyUSBx`` where
|
|
``x`` was the instance number. However, the mapping of USB-based
|
|
serial interfaces can change from one system boot to another, depending on
|
|
which driver the operating system loads first.
|
|
This inconsistency can be problematic when you
|
|
use multiple serial interfaces.
|
|
For example, both console-server connections and a serial-backed
|
|
:ref:`wwan-interface`.
|
|
|
|
To address this issue, and because many low-cost USB-to-serial converters
|
|
do not have a programmed serial number, VyOS now identifies USB-to-serial
|
|
interfaces by the USB root bridge and the bus they connect to.
|
|
This approach is similar to the network interface naming conventions used in
|
|
recent Linux distributions.
|
|
|
|
|
|
.. opcmd:: show hardware usb
|
|
|
|
Retrieve a tree-like representation of all connected USB devices.
|
|
|
|
.. note:: If a device is unplugged and plugged in again, it is assigned a new
|
|
``Port``, ``Dev``, and ``If``.
|
|
|
|
.. code-block:: none
|
|
|
|
vyos@vyos:~$ show hardware usb
|
|
/: Bus 03.Port 1: Dev 1, Class=root_hub, Driver=ehci-pci/2p, 480M
|
|
|__ Port 1: Dev 2, If 0, Class=Hub, Driver=hub/4p, 480M
|
|
|__ Port 3: Dev 4, If 0, Class=Vendor Specific Class, Driver=qcserial, 480M
|
|
|__ Port 3: Dev 4, If 2, Class=Vendor Specific Class, Driver=qcserial, 480M
|
|
|__ Port 3: Dev 4, If 3, Class=Vendor Specific Class, Driver=qcserial, 480M
|
|
|__ Port 3: Dev 4, If 8, Class=Vendor Specific Class, Driver=qmi_wwan, 480M
|
|
/: Bus 02.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/2p, 5000M
|
|
/: Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/2p, 480M
|
|
|__ Port 1: Dev 2, If 0, Class=Vendor Specific Class, Driver=pl2303, 12M
|
|
|__ Port 2: Dev 3, If 0, Class=Hub, Driver=hub/4p, 480M
|
|
|__ Port 4: Dev 5, If 2, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 5, If 0, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 5, If 3, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 5, If 1, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 3: Dev 4, If 0, Class=Hub, Driver=hub/4p, 480M
|
|
|__ Port 3: Dev 6, If 0, Class=Hub, Driver=hub/4p, 480M
|
|
|__ Port 4: Dev 8, If 2, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 8, If 0, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 8, If 3, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 8, If 1, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 7, If 3, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 7, If 1, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 7, If 2, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|__ Port 4: Dev 7, If 0, Class=Vendor Specific Class, Driver=ftdi_sio, 480M
|
|
|
|
|
|
.. opcmd:: show hardware usb serial
|
|
|
|
Retrieve a list and description of all connected USB serial devices. The
|
|
device name displayed, (for example ``usb0b2.4p1.0``), can be used
|
|
directly when accessing the serial console as console-server device.
|
|
|
|
.. code-block:: none
|
|
|
|
vyos@vyos$ show hardware usb serial
|
|
Device Model Vendor
|
|
------ ------ ------
|
|
usb0b1.3p1.0 MC7710 Sierra Wireless, Inc.
|
|
usb0b1.3p1.2 MC7710 Sierra Wireless, Inc.
|
|
usb0b1.3p1.3 MC7710 Sierra Wireless, Inc.
|
|
usb0b1p1.0 USB-Serial_Controller_D Prolific Technology, Inc.
|
|
usb0b2.3.3.4p1.0 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.3.4p1.1 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.3.4p1.2 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.3.4p1.3 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.4p1.0 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.4p1.1 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.4p1.2 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.3.4p1.3 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.4p1.0 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.4p1.1 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.4p1.2 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
usb0b2.4p1.3 Quad_RS232-HS Future Technology Devices International, Ltd
|
|
|
|
.. _information_version:
|
|
|
|
########
|
|
Version
|
|
########
|
|
|
|
.. opcmd:: show version
|
|
|
|
Return the currently running VyOS version and build information. This includes
|
|
the name of the release train, e.g., ``sagitta`` on VyOS 1.4, and ``circinus`` on VyOS 1.5.
|
|
|
|
.. code-block:: none
|
|
|
|
vyos@vyos:~$ show version
|
|
|
|
Version: VyOS 1.4-rolling-202106270801
|
|
Release Train: sagitta
|
|
|
|
Built by: autobuild@vyos.net
|
|
Built on: Sun 27 Jun 2021 09:50 UTC
|
|
Build UUID: ab43e735-edcb-405a-9f51-f16a1b104e52
|
|
Build Commit ID: f544d75eab758f
|
|
|
|
Architecture: x86_64
|
|
Boot via: installed image
|
|
System type: KVM guest
|
|
|
|
Hardware vendor: QEMU
|
|
Hardware model: Standard PC (i440FX + PIIX, 1996)
|
|
Hardware S/N:
|
|
Hardware UUID: Unknown
|
|
|
|
Copyright: VyOS maintainers and contributors
|
|
|
|
.. opcmd:: show version kernel
|
|
|
|
Return the version number of the currently running Linux kernel.
|
|
|
|
.. code-block:: none
|
|
|
|
vyos@vyos:~$ show version kernel
|
|
5.10.46-amd64-vyos
|
|
|
|
.. opcmd:: show version frr
|
|
|
|
Return the version number of FRR (Free Range Routing - https://frrouting.org/)
|
|
used in this release. This is the routing control plane and a successor to GNU
|
|
Zebra and Quagga.
|
|
|
|
.. code-block:: none
|
|
|
|
vyos@vyos:~$ show version frr
|
|
FRRouting 7.5.1-20210625-00-gf07d935a2 (vyos).
|
|
Copyright 1996-2005 Kunihiro Ishiguro, et al.
|
|
|