BEZEICHNUNG

ftok - konvertiert einen Pfadnamen und einen Projektbezeichner in einen System-V-IPC-Schlüssel

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <sys/ipc.h>

key_t ftok(const char *Pfadname, int Projektkennung);

BESCHREIBUNG

Die Funktion ftok() verwendet die Identität der durch Pfadname (muss auf eine existierende Datei ohne Zugriffsbeschränkungen weisen) angegebenen Datei und die niederwertigsten 8 Bit von Projektkennung (muss ungleich Null sein) für die Erzeugung eines System-V-IPC-Schlüssels des Typs key_t. Der Schlüssel eignet sich für den Einsatz mit msgget(2), semget(2) oder shmget(2).

Der resultierende Wert ist der gleiche für alle Pfadnamen, welche die gleiche Datei benennen, wenn der gleiche Wert von Projektkennung verwendet wird. Der Rückgabewert sollte ein anderer sein, wenn sich die (gleichzeitig bestehenden) Dateien oder die Projektkennungen unterscheiden.

RÜCKGABEWERT

Bei Erfolg wird der erzeugte Wert vom Typ key_t zurückgegeben, ansonsten -1 und der Fehlerindikator errno wird wie beim Systemaufruf stat(2) gesetzt.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS

POSIX.1-2008.

GESCHICHTE

POSIX.1-2001.

ANMERKUNGEN

Auf einigen sehr alten Systemen war der Prototyp:

key_t ftok(char *Pfadname, char Projektkennung);

Heute ist Projektkennung ein int, es werden aber immer noch nur 8 Bit verwendet. Typische Anwendungen verwenden für Projektkennung ein ASCII-Zeichen, weshalb das Verhalten nicht definiert ist, wenn Projektkennung gleich Null ist.

Natürlich kann nicht garantiert werden, dass der resultierende key_t-Schlüssel eindeutig ist. Normalerweise verbindet ein umfassendes Herangehen das gegebene Projektkennung-Byte, die unteren 16 Bits der Inode-Nummer und die unteren 8 Bit der Gerätenummer zu einem 32-Bit-Ergebnis. Kollisionen können leicht vorkommen, zum Beispiel zwischen Dateien auf /dev/hda1 und Dateien auf /dev/sda1.

BEISPIELE

Siehe semget(2).

SIEHE AUCH

msgget(2), semget(2), shmget(2), stat(2), sysvipc(7)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Schulze <joey@infodrom.org>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.