La página de manual (página de manual) es un manual de documentación de diferentes comandos disponibles en sistemas operativos Unix o similares a Unix.
Para verificar la entrada manual para cualquier uso de comando, man command_name
En este artículo, estoy usando el comando printf para mis demostraciones.
man printf
Producción:
PRINTF(1) User Commands PRINTF(1) NAME printf - format and print data SYNOPSIS printf FORMAT [ARGUMENT]... printf OPTION DESCRIPTION Print ARGUMENT(s) according to FORMAT, or execute according to OPTION: --help display this help and exit --version output version information and exit FORMAT controls the output as in C printf. Interpreted sequences are: \" double quote \\ backslash \a alert (BEL) ...
Si observa cuidadosamente la salida anterior, la línea superior contiene PRINTF(1) , el 1 entre llaves es el tipo de entrada man. El número corresponde básicamente a la sección de la página del manual.
El manual está dividido en 8 secciones, que son (en Research Unix, BSD, macOS y Linux):
Sección | Descripción |
1 | Comandos Generales |
2 | Llamadas al sistema |
3 | Funciones de biblioteca, que cubren en particular la biblioteca estándar de C |
4 | Archivos especiales (generalmente dispositivos, los que se encuentran en /dev) y controladores |
5 | Formatos de archivo y convenciones |
6 | Juegos y salvapantallas |
7 | Miscelánea |
8 | Comandos y demonios de administración del sistema |
Continuemos con el ejemplo de PRINTF , para todas las entradas, pruebe el siguiente comando:
man -a printf
Producción:
PRINTF(1) User Commands PRINTF(1) NAME printf - format and print data SYNOPSIS printf FORMAT [ARGUMENT]... printf OPTION DESCRIPTION Print ARGUMENT(s) according to FORMAT, or execute according to OPTION: --help display this help and exit --version output version information and exit FORMAT controls the output as in C printf. Interpreted sequences are: \" double quote ...
Cuando escribe q para salir, el siguiente texto aparece en la terminal, presione enter para continuar y ver otra entrada de printf
--Man-- next: printf(3) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]
Salida continuada:
PRINTF(3) Linux Programmer's Manual PRINTF(3) NAME printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf - formatted output conversion SYNOPSIS #include int printf(const char *format, ...); int fprintf(FILE *stream, const char *format, ...); int dprintf(int fd, const char *format, ...); int sprintf(char *str, const char *format, ...); int snprintf(char *str, size_t size, const char *format, ...); #include int vprintf(const char *format, va_list ap); int vfprintf(FILE *stream, const char *format, va_list ap); ...
Para verificar una entrada específica en printf o cualquier otro comando, puede proporcionar directamente el número de sección, por ejemplo:
man 3 printf
Salida: Mostrará la entrada man correspondiente a la sección 3 de printf.
Algunas opciones útiles del comando man:
1) Opción -f
man -f printf
Salida:
Mostrará la breve descripción de printf, si está disponible similar a
printf - format and print data
2) opción -k
man -k printf
Salida:
buscará las descripciones breves de la página del manual para palabras clave y mostrará las coincidencias.
printf (1) - format and print data printf (1p) - write formatted output printf (3) - formatted output conversion printf (3p) - print formatted output printf [builtins] (1) - bash built-in commands, see bash(1)
3) Opción -w
Imprime la ubicación de los archivos cat que se mostrarán en lugar del contenido de los archivos.
man -w printf
Producción:
/usr/share/man/man1/printf.1.gz
4) Opción -K Buscará
texto en todas las páginas del manual.
man -K printf
Salida:
mostrará todas las entradas man que contengan la palabra clave printf, y después de que se muestre cada entrada, puede presionar enter para ver la segunda entrada.
Por ejemplo:
se le solicita a continuación que vea la segunda entrada para printf, puede omitirla o salir para finalizar el comando.
--Man-- next: git-show(1) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]
Referencias:
1) wiki/Man_page
2) Man entrada de man