Subrutina abierta, openat, openx, openxat, open64, open64at, open64x, open64xat, creat o creat64

Finalidad

Abre un archivo para leer o escribir.

Sintaxis

#include <fcntl.h>

int creat (Path, Mode)
const char *Path;
mode_t Mode;

int open64 (Path, OFlag [, Mode])
const char *Path;
int OFlag;
mode_t Mode;

int open64at (DirFileDescriptor, Path, 
OFlag [, Mode])
int DirFileDescriptor;
const char * Path;
int OFlag;
mode_t Mode;

int creat64 (Path, Mode)
const char *Path;
mode_t Mode;

int open64x (Path, OFlag, Mode, Extension)
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

int open64xat (DirFileDescriptor, Path, OFlag, Mode, Extension)
int DirFileDescriptor;
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

Descripción

La subrutina openat es equivalente a la subrutina open si el parámetro DirFileDescriptor es AT_FDCWD o el parámetro Path es un nombre de ruta absoluto. Si DirFileDescriptor es un descriptor de archivo válido de un directorio abierto y Path es un nombre de ruta relativo, Path se considera relativo al directorio que está asociado con el parámetro DirFileDescriptor en lugar del directorio de trabajo actual. Del mismo modo, las subrutinas openxat, open64at u open64xat son equivalentes a las subrutinas openx, open64 u open64x, respectivamente, del mismo modo que openat y open.

Las subrutinas open, openx y creat establecen una conexión entre el archivo nombrado por el parámetro Path y un descriptor de archivo. El descriptor de archivo abierto es utilizado por las subrutinas de E/S posteriores, como lectura y escritura, para acceder a ese archivo.

La subrutina openx es la misma que la subrutina open, con la adición de un parámetro Extensión, que se proporciona para el uso del controlador de dispositivo. La subrutina creat es equivalente a la subrutina open con los indicadores O_WRONLY, O_CREAT y O_TRUNC activados.

El descriptor de archivo devuelto es el descriptor de archivo más bajo no abierto anteriormente para ese proceso. Ningún proceso puede tener más de OPEN_MAX descriptores de archivo abiertos simultáneamente.

El desplazamiento del archivo, marcando la posición actual dentro del archivo, se establece en el principio del archivo. El nuevo descriptor de archivo se establece para permanecer abierto en las subrutinas exec.

Las subrutinas open64 y creat64 son equivalentes a las subrutinas open y creat excepto en que la bandera O_LARGEFILE se establece en la descripción del archivo abierto asociado con el descriptor de archivo devuelto. Esta bandera permite acceder a ficheros mayores que OFF_MAX. Si la persona que llama intenta abrir un archivo mayor que OFF_MAX y O_LARGEFILE no está establecido, la apertura fallará y errno será establecido a EOVERFLOW.

En el entorno de programación habilitado para archivos grandes, open se redefine como open64 y creat se redefine como creat64.

La subrutina open64x crea y accede a un archivo encriptado en un Sistema de Archivo EncriptadoEFS). La subrutina open64x es similar a la subrutina openx, con la modificación del parámetro OFlag, que se actualiza a una cantidad de 64 bits.

Si el parámetro DirFileDescriptor de la subrutina openat, openxat, open64at o open64xat se abrió sin el indicador de apertura O_SEARCH, la subrutina comprueba si se permiten búsquedas en el directorio utilizando los permisos actuales del directorio. Si el directorio se abrió con la bandera de apertura O_SEARCH, la subrutina no realiza la comprobación para ese directorio.

Parámetros

Indicadores que especifican el tipo de acceso

Los siguientes valores de distintivo de parámetro de OFlag especifican el tipo de acceso:

Indicadores que especifican un procesamiento abierto especial

Los siguientes valores de distintivo de parámetro de OFlag especifican un proceso abierto especial:

La subrutina open no tiene éxito si se cumple alguna de las siguientes condiciones:

• El archivo da soporte a bloqueos de registro aplicados y otro proceso ha bloqueado una parte del archivo.
• El archivo está en un sistema de archivos físico y ya está abierto con el distintivo O_RSHARE o el distintivo O_NSHARE .
• El archivo no permite el acceso de escritura.
• El archivo ya está abierto para actualización diferida.

Indicador que especifica el tipo de actualización

Un programa puede solicitar algún control sobre cuándo se deben hacer permanentes las actualizaciones para un archivo regular abierto para el acceso de escritura. Los siguientes valores de parámetro de OFlag especifican el tipo de actualización realizada:

Indicadores que definen el estado inicial del archivo abierto

Los siguientes valores de distintivo de parámetro de OFlag definen el estado inicial del archivo abierto:

La bandera O_NDELAY y la bandera O_NONBLOCK son idénticas excepto por el valor devuelto por las subrutinas de lectura y escritura. Estos distintivos significan que el proceso no bloquea el estado de un objeto, sino que bloquea la entrada o salida a un archivo o dispositivo de bloque normal.

El distintivo O_DELAY sólo es relevante cuando se utiliza con los distintivos O_NSHARE o O_RSHARE . No está relacionado con los distintivos O_NDELAY y O_NONBLOCK .

Notas generales sobre los indicadores de parámetros OFlag

El efecto del distintivo O_CREAT es inmediato, incluso si el archivo se abre con el distintivo O_DEFER .

Al abrir un archivo en un sistema de archivos físico con el distintivo O_NSHARE o el distintivo O_RSHARE , si el archivo ya está abierto con acceso en conflicto, se puede producir lo siguiente:

• Si el indicador O_DELAY está desactivado (por defecto), la subrutina de apertura no tiene éxito.
• Si el indicador O_DELAY está activado, la subrutina de apertura se bloquea hasta que no haya ninguna apertura conflictiva. No hay ninguna detección de punto muerto para los procesos utilizando el distintivo O_DELAY .

Al abrir un archivo en un sistema de archivos físico que ya se ha abierto con el distintivo O_NSHARE , se puede producir lo siguiente:

• Si el distintivo O_DELAY es claro (el valor predeterminado), la apertura no es satisfactoria inmediatamente.
• Si se establece el distintivo O_DELAY , los bloques abiertos hasta que no haya ningún conflicto abierto.

Al abrir un archivo con el distintivo O_RDWR, O_WRONLYo O_TRUNC y el archivo ya está abierto con el distintivo O_RSHARE :

• Si el distintivo O_DELAY es claro (el valor predeterminado), la apertura no es satisfactoria inmediatamente.
• Si se establece el distintivo O_DELAY , los bloques abiertos hasta que no haya ningún conflicto abierto.

Al abrir un primer inicio (FIFO) con el distintivo O_RDONLY , se puede producir lo siguiente:

• Si las banderas O_NDELAY y O_NONBLOCK están claras, la apertura se bloquea hasta que un proceso abre el fichero para escritura. Si el archivo ya está abierto para escritura (incluso por el proceso de llamada), la subrutina open vuelve sin demora.
• Si se establece el distintivo O_NDELAY o el distintivo O_NONBLOCK , la apertura se realiza de forma inmediata aunque ningún proceso tenga la FIFO abierta para escritura.

Al abrir un FIFO con el distintivo O_WRONLY , se puede producir lo siguiente:

• Si los distintivos O_NDELAY y O_NONBLOCK son claros (el valor predeterminado), los bloques abiertos hasta que un proceso abre el archivo para lectura. Si el archivo ya está abierto para escritura (incluso por el proceso de llamada), la subrutina open vuelve sin demora.
• Si la bandera O_NDELAY o la bandera O_NONBLOCK está activada, la subrutina open devuelve un error si ningún proceso tiene actualmente el fichero abierto para lectura.

Cuando se abre un archivo especial de caracteres o especial de bloque que da soporte a aperturas no de bloqueo, como por ejemplo un dispositivo de terminal, se puede producir lo siguiente:

• Si los distintivos O_NDELAY y O_NONBLOCK son claros (el valor predeterminado), los bloques abiertos hasta que el dispositivo esté listo o disponible.
• Si se activa la bandera O_NDELAY o la bandera O_NONBLOCK, la subrutina open vuelve sin esperar a que el dispositivo esté listo o disponible. El comportamiento posterior del dispositivo es específico del dispositivo.

Cualquier información adicional sobre el efecto, si lo hay, de las banderas O_NDELAY, O_RSHARE, O_NSHARE y O_DELAY en un dispositivo específico se documenta en la descripción del archivo especial relacionado con el tipo de dispositivo.

Si la ruta se refiere a un archivo STREAMS, oflag puede construirse a partir de O_NONBLOCK OR-ed con O_RDONLY, O_WRONLY o O_RDWR. Otros valores de distintivo no son aplicables a los dispositivos STREAMS y no tienen ningún efecto en ellos. El valor O_NONBLOCK afecta a la operación de los controladores STREAMS y a determinadas funciones aplicadas a los descriptores de archivo asociados a los archivos STREAMS. Para los controladores STREAMS, la implementación de O_NONBLOCK es específica del dispositivo.

Si path nombra el lado del controlador de un dispositivo pseudo-terminal, entonces no se especifica si open bloquea el lado del trabajador para que no se pueda abrir. Las aplicaciones portátiles deben llamar a unlockpt antes de abrir el lado del trabajador.

El distintivo O_SEARCH tiene el mismo valor que el distintivo O_EXEC . A partir de AIX® 7.1, los programas que han pasado el distintivo O_EXEC a un directorio abierto pueden fallar, ya que el código abierto también comprobará el permiso de búsqueda para el directorio.

El mayor valor que pueda representarse correctamente en un objeto de tipo off_t se establecerá como desplazamiento máximo en la descripción del fichero abierto.

Valores de retorno

Tras la finalización satisfactoria, se devuelve el descriptor de archivo, un entero no negativo. En caso contrario, se devuelve un valor de -1, no se crea ni modifica ningún archivo y se establece la variable global errno para indicar el error.

Códigos de error

Las subrutinas open,openat openx, openxat, open64, open64at, open64x, open64xat y creat no tienen éxito y el archivo nombrado no se abre si se cumple una o más de las siguientes condiciones:

Las subrutinas open, openx, open64x y creat no tienen éxito si se cumple una de las siguientes condiciones:

Las subrutinas openat, openxat, open64at y open64xat no tienen éxito y el archivo nombrado no se abre si se cumple una o más de las siguientes condiciones: