catman - pomocník manuálov

Pokiaľ si nevieme pomôcť v linuxe, musíme sa pozrieť do nejakej encyklopédie. Okrem internetu existuje manuál príkazov. Príkaz man určite dobre poznáme.




príkaz man nam vypíše manuál daného príkazu. (Napríklad manuál milovaného VLC prehrávača.)


martin@guliverkel:~$ man vlc

časť manuálu je uvedená tu:


VLC(1)                                                                                                                   General Commands Manual                                                                                                                  VLC(1)

NAME
       vlc, qvlc, svlc, nvlc, rvlc, cvlc - the VLC media player

SYNOPSIS
       vlc [OPTIONS] [ITEMS]...

DESCRIPTION
       This manual page documents briefly the VLC multimedia player and server.


Manuál príkazu môžeme prečítať aj, keď ho nepoznáme. (Napr. v Debiane 9 ako bežný užívateľ nemôžeme spustiť ifconfig. Ale manuál prečítať môžeme.)

martin@guliverkel:~$ ifconfig

bash: ifconfig: command not found

martin@guliverkel:~$ man ifconfig

Tu je kúsok z man ifconfig

IFCONFIG(8)                                                                                                        Linux System Administrator's Manual                                                                                                       IFCONFIG(8)

NAME

       ifconfig - configure a network interface

SYNOPSIS

       ifconfig [-v] [-a] [-s] [interface]

       ifconfig [-v] interface [aftype] options | address ...

DESCRIPTION

       Ifconfig is used to configure the kernel-resident network interfaces.  It is used at boot time to set up interfaces as necessary.  After that, it is usually only needed when debugging or when system tuning is needed.

Príkaz catman

catman slúži na vytváranie alebo updatovanie manuálov. Ako bežný užívateľ nemáme právo pracovať s týmto nástrojom. Tu je vysvetlené prečo:

martin@guliverkel:~$ catman

catman: cannot write within /var/cache/man/cat1: Permission denied

catman: cannot write within /var/cache/man/cat8: Permission denied

catman: cannot write within /var/cache/man/cat3: Permission denied

catman: cannot write within /var/cache/man/cat2: Permission denied

catman: cannot write within /var/cache/man/cat5: Permission denied

catman: cannot write within /var/cache/man/cat4: Permission denied

catman: cannot write within /var/cache/man/cat6: Permission denied

catman: cannot write within /var/cache/man/cat7: Permission denied

martin@guliverkel:~$ 

Skúsme ho spustiť ako root: 

root@guliverkel:/home/martin# catman 

Updating cat files for section 1 of man hierarchy /usr/share/man

2to3-2.7, 2to3-3.5, 7z, 7za, 7zr, Xorg.wrap, acpi_available, 

- už sa nám updatuju manuály k programom ( vypisuje nám aj lokalitu)

- existuje aj konfiguračný nástroj: /etc/manpath.config

- catman má aj debug mód:

catman -d 

Čítajte aj: 

https://www.systutorials.com/docs/linux/man/8-catman/ 

https://factorpad.com/tech/linux-essentials/man-command.html

PS: Neučme sa príkazy s manuálmi ako na Hviezdoslav Kubín, tak ako si knihovník musí ísť po svoju encyklopédiu, tak aj linuxový admin má svoje nástroje: