open, openat, openx, openxat, open64, open64at, open64x, open64xat, creat oder creat64 Subroutine

Zweck

Öffnet eine Datei zum Lesen oder Schreiben.

Syntax

#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;

Beschreibung

Das Unterprogramm openat entspricht dem Unterprogramm open, wenn der Parameter DirFileDescriptor AT_FDCWD oder der Parameter Path ein absoluter Pfadname ist. Wenn DirFileDescriptor ein gültiger Dateideskriptor eines geöffneten Verzeichnisses und Path ein relativer Pfadname ist, wird Path als relativ zu dem Verzeichnis betrachtet, das mit dem DirFileDescriptor verbunden ist, und nicht als relativ zum aktuellen Arbeitsverzeichnis. Ebenso sind die Unterprogramme openxat, open64at oder open64xat äquivalent zu den Unterprogrammen openx, open64 oder open64x, genau wie openat und open.

Die Unterprogramme open, openx und creat stellen eine Verbindung zwischen der durch den Parameter Path benannten Datei und einem Dateideskriptor her. Der geöffnete Dateideskriptor wird von nachfolgenden E/A-Unterprogrammen, wie z. B. Lesen und Schreiben, für den Zugriff auf diese Datei verwendet.

Das Unterprogramm openx ist dasselbe wie das Unterprogramm open, mit dem Zusatz eines Erweiterungsparameters, der für die Verwendung durch Gerätetreiber vorgesehen ist. Das Unterprogramm creat entspricht dem Unterprogramm open mit den gesetzten Flags O_WRONLY, O_CREAT und O_TRUNC.

Der zurückgegebene Dateideskriptor ist der niedrigste Dateideskriptor, der zuvor für diesen Prozess nicht geöffnet war. Kein Prozess kann mehr als OPEN_MAX Dateideskriptoren gleichzeitig öffnen.

Der Dateioffset, der die aktuelle Position innerhalb der Datei markiert, wird auf den Anfang der Datei gesetzt. Der neue Dateideskriptor wird so definiert, dass er über Exec-Subroutinen geöffnet bleibt.

Die Unterprogramme open64 und creat64 entsprechen den Unterprogrammen open und creat, mit dem Unterschied, dass in der Beschreibung der geöffneten Datei, die mit dem zurückgegebenen Dateideskriptor verbunden ist, das Flag O_LARGEFILE gesetzt ist. Dieses Flag ermöglicht den Zugriff auf Dateien, die größer als OFF_MAX sind. Wenn der Aufrufer versucht, eine Datei zu öffnen, die größer als OFF_MAX ist und O_LARGEFILE nicht gesetzt ist, schlägt das Öffnen fehl und errno wird auf EOVERFLOW gesetzt.

In der Programmierumgebung für große Dateien wird open zu open64 und creat zu creat64 umdefiniert.

Das Unterprogramm open64x erstellt eine verschlüsselte Datei in einem Encrypting File SystemEFS) und greift darauf zu. Das Unterprogramm open64x ähnelt dem Unterprogramm openx, mit der Änderung des Parameters OFlag, der auf eine 64-Bit-Größe aktualisiert wird.

Wenn der Parameter DirFileDescriptor im Unterprogramm openat, openxat, open64at oder open64xat ohne das Open-Flag O_SEARCH geöffnet wurde, prüft das Unterprogramm anhand der aktuellen Berechtigungen des Verzeichnisses, ob eine Verzeichnissuche für dieses Verzeichnis erlaubt ist. Wenn das Verzeichnis mit dem Open-Flag O_SEARCH geöffnet wurde, führt das Unterprogramm die Prüfung für dieses Verzeichnis nicht durch.

Parameter

Flaggen, die die Zugriffsart angeben

Die folgenden OFlag (Flag) -Parameterflagwerte geben den Zugriffstyp an:

Flaggen, die eine spezielle offene Verarbeitung angeben

Die folgenden OFlag (Flag) -Parametermarkierungswerte geben eine spezielle Öffnungsverarbeitung an:

Das Unterprogramm open ist nicht erfolgreich, wenn eine der folgenden Bedingungen erfüllt ist:

• Die Datei unterstützt erzwungene Satzsperren und ein anderer Prozess hat einen Teil der Datei gesperrt.
• Die Datei befindet sich in einem physischen Dateisystem und ist bereits mit dem Flag O_RSHARE oder O_NSHARE geöffnet.
• Die Datei lässt keinen Schreibzugriff zu.
• Die Datei ist bereits für verzögerte Aktualisierung geöffnet.

Kennzeichen, das die Art der Aktualisierung angibt

Ein Programm kann eine gewisse Steuerung anfordern, wann Aktualisierungen für eine reguläre Datei, die für Schreibzugriff geöffnet wird, permanent gemacht werden sollen. Die folgenden OFlag (Flag) -Parameterwerte geben den Typ der ausgeführten Aktualisierung an:

Flaggen, die den Anfangszustand der offenen Datei definieren

Die folgenden OFlag (Flag) -Parameterflagwerte definieren den Anfangsstatus der geöffneten Datei:

Das O_NDELAY-Flag und das O_NONBLOCK-Flag sind bis auf den von den Lese- und Schreibunterprogrammen zurückgegebenen Wert identisch. Diese Flags bedeuten, dass der Prozess nicht im Status eines Objekts blockiert, sondern bei der Eingabe oder Ausgabe in eine reguläre Datei oder Blockeinheit blockiert wird.

Das Flag O_VERZÖGERUNG ist nur relevant, wenn es mit dem Flag O_NSHARE oder O_RSHARE verwendet wird. Sie bezieht sich nicht auf die Flags O_NVERZÖGERUNG und O_NICHT_BLOCK .

Allgemeine Hinweise zu OFlag-Parameterflags

Das Flag O_CREAT wirkt sich sofort aus, auch wenn die Datei mit dem Flag O_DEFER geöffnet wird.

Wenn eine Datei in einem physischen Dateisystem mit dem Flag O_NSHARE oder dem Flag O_RSHARE geöffnet wird und die Datei bereits mit einem Zugriffskonflikt geöffnet ist, kann Folgendes auftreten:

• Wenn das Flag O_DELAY nicht gesetzt ist (Standardeinstellung), ist das Unterprogramm open nicht erfolgreich.
• Wenn das Flag O_DELAY gesetzt ist, blockiert das Unterprogramm open so lange, bis es keinen Konflikt mehr mit open gibt. Es gibt keine Deadlock-Erkennung für Prozesse, die das Flag O_VERZÖGERUNG verwenden.

Beim Öffnen einer Datei in einem physischen Dateisystem, das bereits mit dem Flag O_NSHARE geöffnet wurde, kann Folgendes auftreten:

• Wenn das Flag O_VERZÖGERUNG abgewählt ist (Standardeinstellung), ist das Öffnen sofort nicht erfolgreich.
• Wenn das Flag O_VERZÖGERUNG gesetzt ist, werden die offenen Blöcke blockiert, bis keine Konflikte beim Öffnen mehr auftreten.

Wenn Sie eine Datei mit dem Flag O_RDWR, O_WRONLYoder O_TRUNC öffnen und die Datei bereits mit dem Flag O_RSHARE geöffnet ist:

• Wenn das Flag O_VERZÖGERUNG abgewählt ist (Standardeinstellung), ist das Öffnen sofort nicht erfolgreich.
• Wenn das Flag O_VERZÖGERUNG gesetzt ist, werden die offenen Blöcke blockiert, bis keine Konflikte beim Öffnen mehr auftreten.

Beim Öffnen eines First In/First Out (FIFO) mit dem Flag O_RDONLY kann Folgendes auftreten:

• Wenn die O_NDELAY- und O_NONBLOCK-Flags nicht gesetzt sind, wird die geöffnete Datei blockiert, bis ein Prozess die Datei zum Schreiben öffnet. Wenn die Datei bereits zum Schreiben geöffnet ist (auch durch den aufrufenden Prozess), kehrt das Unterprogramm open ohne Verzögerung zurück.
• Wenn das Flag O_NVERZÖGERUNG oder das Flag O_NICHT_BLOCK gesetzt ist, ist das Öffnen sofort erfolgreich, auch wenn kein Prozess das FIFO zum Schreiben geöffnet hat.

Beim Öffnen einer FIFO-Warteschlange mit dem Flag O_WRONLY kann Folgendes auftreten:

• Wenn die Flags O_NVERZÖGERUNG und O_NICHT_BLOCK abgewählt sind (Standardeinstellung), wird das Öffnen blockiert, bis ein Prozess die Datei zum Lesen öffnet. Wenn die Datei bereits zum Schreiben geöffnet ist (auch durch den aufrufenden Prozess), kehrt das Unterprogramm open ohne Verzögerung zurück.
• Wenn das Flag O_NDELAY oder das Flag O_NONBLOCK gesetzt ist, gibt das Unterprogramm open einen Fehler zurück, wenn kein Prozess die Datei gerade zum Lesen geöffnet hat.

Beim Öffnen einer Blockspezial-oder Zeichengerätedatei, die nicht blockierende Öffnungsvorgänge unterstützt, wie z. B. eine Terminaleinheit, kann Folgendes auftreten:

• Wenn die Flags O_NVERZÖGERUNG und O_NICHT_BLOCK abgewählt sind (Standardeinstellung), werden die offenen Blöcke blockiert, bis die Einheit bereit oder verfügbar ist.
• Wenn das Flag O_NDELAY oder das Flag O_NONBLOCK gesetzt ist, kehrt das Unterprogramm open zurück, ohne darauf zu warten, dass das Gerät bereit oder verfügbar ist. Das nachfolgende Verhalten der Einheit ist einheitenspezifisch.

Alle zusätzlichen Informationen über die Auswirkungen der O_NDELAY-, O_RSHARE-, O_NSHARE- und O_DELAY-Flags auf ein bestimmtes Gerät sind in der Beschreibung der speziellen Datei für den Gerätetyp dokumentiert, falls vorhanden.

Wenn sich der Pfad auf eine STREAMS-Datei bezieht, kann oflag aus O_NONBLOCK ODER mit entweder O_RDONLY, O_WRONLY oder O_RDWR konstruiert werden. Andere Flagwerte gelten nicht für STREAMS-Einheiten und haben keine Auswirkungen auf sie. Der Wert O_NICHT_BLOCK wirkt sich auf die Operation von STREAMS-Treibern und bestimmten Funktionen aus, die auf Dateideskriptoren angewendet werden, die STREAMS-Dateien zugeordnet sind. Für STREAMS-Treiber ist die Implementierung von O_NICHT_BLOCK einheitenspezifisch.

Wenn path die Controllerseite eines Pseudoterminals benennt, ist nicht festgelegt, ob open die Workerseite sperrt, so dass sie nicht geöffnet werden kann. Portable Anwendungen müssen unlockpt aufrufen, bevor sie die Worker-Seite öffnen.

Das Flag O_SUCHE hat denselben Wert wie das Flag O_Exec . Ab AIX® 7.1schlagen Programme, die das Flag O_EXEC an ein geöffnetes Verzeichnis übergeben, möglicherweise fehl, da der offene Code auch die Suchberechtigung für das Verzeichnis überprüft.

Der größte Wert, der in einem Objekt vom Typ off_t korrekt dargestellt werden kann, wird als maximaler Offset in der Beschreibung der geöffneten Datei festgelegt.

Rückgabewerte

Nach erfolgreicher Beendigung wird der Dateideskriptor als nicht negative Ganzzahl zurückgegeben. Andernfalls wird ein Wert von -1 zurückgegeben, es werden keine Dateien erstellt oder geändert und die globale Variable errno wird gesetzt, um den Fehler anzuzeigen.

Fehlercodes

Die Unterprogramme open,openat openx, openxat, open64, open64at, open64x, open64xat und creat sind nicht erfolgreich und die genannte Datei wird nicht geöffnet, wenn eine oder mehrere der folgenden Bedingungen erfüllt sind:

Die Unterprogramme open, openx, open64x und creat sind erfolglos, wenn eine der folgenden Bedingungen erfüllt ist:

Die Unterprogramme openat, openxat, open64at und open64xat sind nicht erfolgreich und die genannte Datei wird nicht geöffnet, wenn eine oder mehrere der folgenden Bedingungen erfüllt sind: