.\" (c) 2000 by Michael Kerrisk (michael.kerrisk@gmx.net)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. 
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.\" Created, 14 Dec 2000 by Michael Kerrisk
.\"
.\" Traducido por Miguel Pérez Ibars <mpi79470@alu.um.es> el 10-julio-2004
.\"
.TH DIRNAME 3  "14 diciembre 2000" "GNU" "Manual del Programador de Linux"
.SH NOMBRE
dirname, basename \- Analiza los componentes de un nombre de ruta
.SH SINOPSIS
.nf
.B #include <libgen.h>
.sp
.BI "char *dirname(char *" path );
.nl
.BI "char *basename(char *" path );
.fi
.SH DESCRIPCIÓN
Las funciones
.B dirname
y
.B basename
descomponen un nombre de ruta terminado en null en un directorio
y un nombre de fichero.
En el caso habitual,
.B dirname
devuelve la cadena que precede, pero no incluye, al último carácter '/', y
.B basename
devuelve el componente que sigue al último carácter '/'.
Los carácteres '/' del final no se cuentan como parte del nombre de ruta.
.PP
Si
.I path
no contiene una barra,
.B dirname
devuelve la cadena "." mientras que
.B basename
devuelve una copia de
.IR path .
Si
.I path
es la cadena "/", entonces tanto
.B dirname
como
.B basename
devuelven la cadena "/".
Si
.I path
es un puntero a NULL o apunta a una cadena vacía, entonces tanto
.B dirname
como
.B basename
devuelven la cadena ".".
.PP
Concatenando la cadena devuelta por
.BR dirname ,
un carácter "/", y la cadena devuelta por
.B basename
se obtiene el nombre de ruta completo.
.PP
Tanto
.B dirname
como
.B basename
pueden modificar el contenido de
.IR path , 
así que si necesita preservar la cadena pathname,
debería pasar una copia de ella a estas funciones. Además,
.B dirname
y
.B basename
pueden devolver punteros a memoria estática
que puede ser sobreescrita en llamadas posteriores.
.PP
La siguiente lista de ejemplos (extraídos de SUSv2)
muestra las cadenas devueltas por
.B dirname
y
.B basename
para diferentes rutas:
.sp
.nf
.B 
ruta  		dirname		basename
"/usr/lib"	"/usr"		"lib"
"/usr/"		"/"  		"usr"
"usr"		"."  		"usr"
"/"  		"/"  		"/"
"."  		"."  		"."
".."  		"."  		".."
.fi
.SH EJEMPLO
.nf
char *dirc, *basec, *bname, *dname;
char *path = "/etc/passwd";

dirc = strdup(path);
basec = strdup(path);
dname = dirname(dirc);
bname = basename(basec);
printf("dirname=%s, basename=%s\\n", dname, bname);
free(dirc);
free(basec);
.fi
.SH "VALOR DEVUELTO"
Tanto
.B dirname
como
.B basename
devuelven punteros a cadenas terminadas en null.
.SH FALLOS
En versiones de glibc anteriores a 2.2.1 (incluída),
.B dirname
no maneja correctamente los nombres de ruta con carácteres '/' al final,
y provoca una violación de segmento si se le pasa un argumento NULL.
.SH "CONFORME A"
SUSv2
.SH "VÉASE TAMBIÉN"
.BR dirname (1),
.BR basename (1),