manpages-de - en to de translation catalogue (47 entries)

note: type: TH
en: 2019-03-06
de: 6. März 2019

note: type: TH
en: Linux Programmer's Manual
de: Linux-Programmierhandbuch

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: getdents, getdents64 - get directory entries
de: getdents, getdents64 - Verzeichniseinträge ermitteln

note: type: SH
en: SYNOPSIS
de: ÜBERSICHT

note: type: Plain text
en: I<Note>: There are no glibc wrappers for these system calls; see NOTES.
de: I<Hinweis:> Es gibt keine Glibc-Wrapper für diese Systemaufrufe; siehe ANMERKUNGEN.

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: These are not the interfaces you are interested in.  Look at B<readdir>(3)  for the POSIX-conforming C library interface.  This page documents the bare kernel system call interfaces.
de: Dies sind nicht die Schnittstellen, an der Sie interessiert sind. Lesen Sie B<readdir>(3) für die POSIX-konforme C-Bibliotheksschnittstelle. Diese Seite dokumentiert die nackten Kernel-Systemaufruf-Schnittstellen.

note: type: Plain text
en: The system call B<getdents>()  reads several I<linux_dirent> structures from the directory referred to by the open file descriptor I<fd> into the buffer pointed to by I<dirp>.  The argument I<count> specifies the size of that buffer.
de: Der Systemaufruf B<getdents>() liest mehrere I<linux_dirent>-Strukturen aus dem Verzeichnis, auf das der offene Dateideskriptor I<fd> verweist, in den Puffer, auf den I<dirp> zeigt. Das Argument I<count> spezifiziert die Größe dieses Puffers.

note: type: Plain text
en: The I<linux_dirent> structure is declared as follows:
de: Die Struktur I<linux_dirent> ist wie folgt deklariert:

note: type: Plain text
en: struct linux_dirent {
        unsigned long  d_ino;     /* Inode number */
        unsigned long  d_off;     /* Offset to next I<linux_dirent> */
        unsigned short d_reclen;  /* Length of this I<linux_dirent> */
        char           d_name[];  /* Filename (null-terminated) */
                          /* length is actually (d_reclen - 2 -
                             offsetof(struct linux_dirent, d_name)) */
        /*
        char           pad;       // Zero padding byte
        char           d_type;    // File type (only since Linux
                                  // 2.6.4); offset is (d_reclen - 1)
        */
    }
de: struct linux_dirent {
        unsigned long  d_ino;     /* Inode-Nummer */
        unsigned long  d_off;     /* Offset zum nächsten I<linux_dirent> */
        unsigned short d_reclen;  /* Länge dieses I<linux_dirent> */
        char           d_name[];  /* Dateiname (abgeschlossen mit */
                                  /* Null-Byte */
                            /* Tatsächlich ist die Länge (d_reclen - 2 -
                               offsetof(struct linux_dirent, d_name)) */
        /*
        char           pad;       // Null-Byte zum Auffüllen
        char           d_type;    // Dateityp (nur seit Linux 2.6.4);
                                  // Offset beträgt (d_reclen - 1)
        */
    }

note: type: Plain text
en: I<d_ino> is an inode number.  I<d_off> is the distance from the start of the directory to the start of the next I<linux_dirent>.  I<d_reclen> is the size of this entire I<linux_dirent>.  I<d_name> is a null-terminated filename.
de: I<d_ino> ist eine Inode-Nummer. I<d_off> ist der Abstand zwischen dem Anfang des Verzeichnisses und dem Anfang des nächsten I<linux_dirent>. I<d_reclen> ist die Größe dieses gesamten I<linux_dirent>. I<d_name> ist ein nullterminierter Dateiname.

note: type: Plain text
en: I<d_type> is a byte at the end of the structure that indicates the file type.  It contains one of the following values (defined in I<E<lt>dirent.hE<gt>>):
de: I<d_type> ist ein Byte am Ende der Struktur, das den Dateityp anzeigt. Es enthält einen der folgenden Werte (definiert in I<E<lt>dirent.hE<gt>>):

note: type: Plain text
en: This is a block device.
de: Dies ist ein blockorientiertes Gerät.

note: type: Plain text
en: This is a character device.
de: Dies ist ein zeichenorientiertes Gerät.

note: type: Plain text
en: This is a directory.
de: Dies ist ein Verzeichnis.

note: type: Plain text
en: This is a named pipe (FIFO).
de: Dies ist ein FIFO (eine benannte Pipe).

note: type: Plain text
en: This is a symbolic link.
de: Dies ist ein symbolischer Link.

note: type: Plain text
en: This is a regular file.
de: Dies ist eine reguläre Datei.

note: type: Plain text
en: This is a UNIX domain socket.
de: Dies ist ein UNIX Domain Socket.

note: type: Plain text
en: The file type is unknown.
de: Der Dateityp ist unbekannt.

note: type: Plain text
en: The I<d_type> field is implemented since Linux 2.6.4.  It occupies a space that was previously a zero-filled padding byte in the I<linux_dirent> structure.  Thus, on kernels up to and including 2.6.3, attempting to access this field always provides the value 0 (B<DT_UNKNOWN>).
de: Das I<d_type>-Feld wird seit Linux 2.6.4 implementiert. Es nimmt den Raum ein, der zuvor ein auf Null gesetztes Füllbyte in der I<linux_dirent>-Struktur war. So ergibt mit Kerneln bis einschließlich 2.6.3 ein versuchter Zugriff auf dieses Feld immer den Wert 0 (B<DT_UNKNOWN>).

note: kernel 2.6.27 The same sentence is in readdir.2 type: Plain text
en: Currently, only some filesystems (among them: Btrfs, ext2, ext3, and ext4)  have full support for returning the file type in I<d_type>.  All applications must properly handle a return of B<DT_UNKNOWN>.
de: Derzeit unterstützen nur ein paar Dateisysteme (darunter Btrfs, ext2, ext3 und ext4) die Rückgabe des Dateityps in I<d_type> vollständig. Alle Anwendungen müssen mit dem Rückgabewert B<DT_UNKNOWN> umgehen können.

note: type: Plain text
en: The original Linux B<getdents>()  system call did not handle large filesystems and large file offsets.  Consequently, Linux 2.4 added B<getdents64>(), with wider types for the I<d_ino> and I<d_off> fields.  In addition, B<getdents64>()  supports an explicit I<d_type> field.
de: Der ursprüngliche Linux-Systemaufuf B<getdents>() konnte nicht mit großen Dateisystemen und großen Dateioffsets umgehen. Folglich wurde in Linux 2.4 B<getdents64>() hinzugefügt, mit »breiteren« Typen für die Felder I<d_ino> und I<d_off> in der I<linux_dirent>-Struktur. Zusätzlich unterstützt B<getdents64>() ein explizites I<d_type>-Feld.

note: type: Plain text
en: The B<getdents64>()  system call is like B<getdents>(), except that its second argument is a pointer to a buffer containing structures of the following type:
de: Der B<getdents64>()-Systemaufruf ähnelt dem von B<getdents>(), außer dass das zweite Argument ein Zeiger auf einen Puffer ist, der Strukturen des folgenden Typs enthält:

note: type: Plain text
en: struct linux_dirent64 {
        ino64_t        d_ino;    /* 64-bit inode number */
        off64_t        d_off;    /* 64-bit offset to next structure */
        unsigned short d_reclen; /* Size of this dirent */
        unsigned char  d_type;   /* File type */
        char           d_name[]; /* Filename (null-terminated) */
    };
de: struct linux_dirent64 {
        ino64_t        d_ino;    /* 64-bit-Inode-Nummer */
        off64_t        d_off;    /* 64-bit-Offset zur nächsten Struktur */
        unsigned short d_reclen; /* Größe dieses Verzeichniseintrags */
        unsigned char  d_type;   /* Dateityp */
        char           d_name[]; /* Dateiname (null-terminiert) */
    };

note: type: SH
en: RETURN VALUE
de: RÜCKGABEWERT

note: type: Plain text
en: On success, the number of bytes read is returned.  On end of directory, 0 is returned.  On error, -1 is returned, and I<errno> is set appropriately.
de: Bei Erfolg wird die Anzahl der gelesenen Bytes zurückgeliefert. Am Verzeichnisende wird 0 zurückgeliefert. Im Fehlerfall wird -1 zurückgeliefert und I<errno> entsprechend gesetzt.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: Invalid file descriptor I<fd>.
de: Unzulässiger Dateideskriptor I<fd>.

note: type: Plain text
en: Argument points outside the calling process's address space.
de: Das Argument zeigt aus dem Adressraum des aufrufenden Prozesses heraus.

note: type: Plain text
en: Result buffer is too small.
de: Ergebnispuffer ist zu klein.

note: type: Plain text
en: No such directory.
de: Kein solches Verzeichnis.

note: type: Plain text
en: File descriptor does not refer to a directory.
de: Dateideskriptor zeigt nicht auf ein Verzeichnis.

note: type: SH
en: CONFORMING TO
de: KONFORM ZU

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: Glibc does not provide a wrapper for these system calls; call them using B<syscall>(2).  You will need to define the I<linux_dirent> or I<linux_dirent64> structure yourself.  However, you probably want to use B<readdir>(3)  instead.
de: Glibc stellt keinen Wrapper für diese Systemaufrufe bereit, rufen Sie sie mit B<syscall>(2) auf. Sie müssen die Struktur I<linux_dirent> oder I<linux_dirent64> selbst definieren. Allerdings möchten Sie wahrscheinlich stattdessen B<readdir>(3) verwenden.

note: type: Plain text
en: These calls supersede B<readdir>(2).
de: Diese Aufrufe ersetzen B<readdir>(2).

note: type: SH
en: EXAMPLE
de: BEISPIEL

note: FIXME The example program needs to be revised, since it uses the older getdents() system call and the structure with smaller field widths. type: Plain text
en: The program below demonstrates the use of B<getdents>().  The following output shows an example of what we see when running this program on an ext2 directory:
de: Das nachfolgende Programm zeigt die Verwendung von B<getdents>(). Die folgende Ausgabe zeigt ein Beispiel davon, was bei der Ausführung des Programms auf einem Ext2-Verzeichnis gesehen werden kann.

note: type: SS
en: Program source
de: Programmquelltext

note: type: Plain text
en: #define _GNU_SOURCE
    #include E<lt>dirent.hE<gt>     /* Defines DT_* constants */
    #include E<lt>fcntl.hE<gt>
    #include E<lt>stdio.hE<gt>
    #include E<lt>unistd.hE<gt>
    #include E<lt>stdlib.hE<gt>
    #include E<lt>sys/stat.hE<gt>
    #include E<lt>sys/syscall.hE<gt>
de: #define _GNU_SOURCE
    #include E<lt>dirent.hE<gt>     /* Definiert DT_*-Konstanten */
    #include E<lt>fcntl.hE<gt>
    #include E<lt>stdio.hE<gt>
    #include E<lt>unistd.hE<gt>
    #include E<lt>stdlib.hE<gt>
    #include E<lt>sys/stat.hE<gt>
    #include E<lt>sys/syscall.hE<gt>

note: type: SH
en: SEE ALSO
de: SIEHE AUCH

note: type: SH
en: COLOPHON
de: KOLOPHON

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.02 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.01 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.
