NOMBRE

       mknod - crea un fichero especial o un fichero regular

SINOPSIS

       #include <sys/types.h>
       #include <sys/stat.h>
       #include <fcntl.h>
       #include <unistd.h>

       int mknod(const char *pathname, mode_t mode, dev_t dev);

DESCRIPCIÓN

       mknod  intenta  crear  en  el  sistema de ficheros un nodo-i (fichero, fichero especial de
       dispositivo o tubería nombrada (FIFO)) llamado pathname,  especificado  por  mode  y  dev.
       mode  especifica  tanto  los permisos de uso como el tipo de nodo-i a crear.  Debe ser una
       combinación (mediante  un  O-lógico)  de  uno  de  los  tipos  de  ficheros  enumerados  a
       continuación  y de los permisos para el nuevo nodo-i.  Los permisos son modificados por la
       máscara umask en la forma usual: los permisos del nodo-i creado son (mode & ~umask).

       El tipo de fichero debe ser uno de los siguientes: S_IFREG,  S_IFCHR,  S_IFBLK  y  S_IFIFO
       para  especificar  un  fichero  normal  (que  será  creado  vacío), un fichero especial de
       caracteres, un fichero especial de bloques o FIFO (tubería con nombre), respectivamente, o
       cero, lo que creará un fichero normal.

       Si  el  tipo  de  fichero es S_IFCHR o S_IFBLK entonces dev especifica los números mayor y
       menor del fichero especial de dispositivo creado; en caso contrario, es ignorado.

       Si pathname ya existe, o es un enlace simbólico, esta llamada fallará devolviendo el error
       EEXIST.

       El  identificador  efectivo de usuario del proceso indica el propietario del nuevo nodo-i.
       Si el directorio que contiene al nodo-i tiene activo el bit de SETGID (fijar  identifcador
       de  grupo)  o  si  el sistema de ficheros es montado con la semántica de grupos de BSD, el
       nuevo nodo heredará la pertenencia al grupo al que pertenezca su directorio padre; en caso
       contrario,  pertenecerá  al  grupo  indicado  por  el  identificador efectivo de grupo del
       proceso.

VALOR DEVUELTO

       mknod devuelve cero si ha funcionado correctamente, -1 si ha ocurrido un  error  (en  cuyo
       caso se asigna a errno un valor apropiado).

ERRORES

       EPERM  mode  solicita  la  creación de algo distinto a una tubería con nombre (FIFO), y el
              invocador no es el superusuario; este error también se devuelve si  el  sistema  de
              ficheros que contiene pathname no soporta el tipo de nodo-i solicitado.

       EINVAL mode  solicita  la  creación  de  algo  diferente  a  un fichero normal, un fichero
              especial de dispositivo o una FIFO.

       EEXIST pathname ya existe.

       EFAULT pathname apunta fuera de su espacio de direcciones permitido.

       EACCES El proceso no tiene permiso de escritura en el directorio padre o no tiene  permiso
              de búsqueda (ejecución) en uno de los directorios incluidos en pathname.

       ENAMETOOLONG
              pathname es demasiado largo.

       ENOENT Un directorio componente de pathname no existe o es un enlace simbólico descolgado.

       ENOTDIR
              Un componente utilizado como directorio en pathname no es, de hecho, un directorio.

       ENOMEM No hay suficiente memoria disponible en el núcleo.

       EROFS  pathname indica un fichero en un sistema de ficheros de sólo-lectura.

       ELOOP  Se han encontrado demasiados enlaces simbólicos al resolver pathname.

       ENOSPC El dispositivo que contiene pathname no tiene espacio para el nuevo nodo-i.

CONFORME A

       SVr4  (pero  la  llamada  requiere privilegios y por esto no es POSIX), 4.4BSD. La versión
       Linux difiere de la SVr4 en que no requiere permisos de superusuario para crear  tuberías,
       y también en que los errores EMULTIHOP, ENOLINK, o EINTR no están documentados.

OBSERVACIONES

       POSIX  1003.1-2001  dice:  "El  único  uso  portable  de  mknod() es para crear un fichero
       especial de tipo FIFO. Si mode es  distinto  de  S_IFIFO  o  dev  es  distinto  de  0,  el
       comportamiento de mknod() es indefinido."

       Bajo  Linux, esta llamada no puede usarse para crear ficheros de tipo directorio o de tipo
       conector, y no puede ser utilizada por otro usuario que no sea el superusuario para  crear
       ficheros normales.  Para crear directorios use mkdir, y para crear FIFOs use mkfifo.

       Existen  numerosas  pegas  en  el  protocolo por debajo de NFS. Algunas de estas afectan a
       mknod.

VÉASE TAMBIÉN

       close(2), fcntl(2), mkdir(2), mount(2), open(2), read(2),  socket(2),  stat(2),  umask(2),
       unlink(2), write(2), fopen(3), mkfifo(3)