manpages-l10n - en to fr translation catalogue (61 entries)

note: type: TH
en: 2024-03-03
fr: 3 mars 2024

note: type: TH
en: Linux man-pages 6.7
fr: Pages du manuel de Linux 6.7

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: ioctl - control device
fr: ioctl – Contrôler les périphériques

note: type: SH
en: LIBRARY
fr: BIBLIOTHÈQUE

note: type: Plain text
en: Standard C library (I<libc>, I<-lc>)
fr: Bibliothèque C standard (I<libc>, I<-lc>)

note: type: Plain text
en: B<int ioctl(int >I<fd>B<, unsigned long >I<op>B<, ...);>\f[R]  /* glibc, BSD */\fR
    B<int ioctl(int >I<fd>B<, int >I<op>B<, ...);>\f[R]            /* musl, other UNIX */\fR
fr: B<int ioctl(int >I<desc_fic>B<, unsigned long >I<opération>B<, ...);>\f[R]  /* glibc, BSD */\fR
    B<int ioctl(int >I<desc_fic>B<, int >I<opération>B<, ...);>\f[R]            /* musl, autres UNIX */\fR

note: type: Plain text
en: The B<ioctl>()  system call manipulates the underlying device parameters of special files.  In particular, many operating characteristics of character special files (e.g., terminals) may be controlled with B<ioctl>()  operations.  The argument I<fd> must be an open file descriptor.
fr: L'appel système B<ioctl>() modifie le comportement des périphériques sous\(hyjacents des fichiers spéciaux. En particulier, de nombreuses caractéristiques des fichiers spéciaux en mode caractère (par exemple des terminaux) peuvent être contrôlées avec des opérations B<ioctl>(). L'argument I<desc_fic> doit être un descripteur de fichier ouvert.

note: type: Plain text
en: The second argument is a device-dependent operation code.  The third argument is an untyped pointer to memory.  It's traditionally B<char *>I<argp> (from the days before B<void *> was valid C), and will be so named for this discussion.
fr: Le second argument est le code de l’opération dépendant du périphérique. Le troisième argument est un pointeur non typé. Il est traditionnellement défini en B<char *>I<argp> (cela date de l'époque avant que B<void *> soit du C valable), et sera ainsi nommé dans le reste de cette page.

note: type: Plain text
en: An B<ioctl>()  I<op> has encoded in it whether the argument is an I<in> parameter or I<out> parameter, and the size of the argument I<argp> in bytes.  Macros and defines used in specifying an B<ioctl>()  I<op> are located in the file I<E<lt>sys/ioctl.hE<gt>>.  See NOTES.
fr: Une I<opération> B<ioctl>() encapsule le fait que l'argument est un paramètre d'I<entrée> ou de I<sortie> ainsi que la taille de l'argument I<argp> en octets. Les macros et définitions décrivant une I<opération> B<ioctl>() se trouvent dans le fichier I<E<lt>sys/ioctl.hE<gt>>. Voir NOTES.

note: type: SH
en: RETURN VALUE
fr: VALEUR RENVOYÉE

note: type: Plain text
en: Usually, on success zero is returned.  A few B<ioctl>()  operations use the return value as an output parameter and return a nonnegative value on success.  On error, -1 is returned, and I<errno> is set to indicate the error.
fr: En général, B<ioctl> renvoie B<0> s'il réussit. Certaines opérations B<ioctl> utilisent la valeur de retour comme paramètre de sortie et renvoient une valeur non négative si elles réussissent. En cas d'échec, B<-1> est renvoyé et I<errno> est positionnée pour indiquer l'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: I<fd> is not a valid file descriptor.
fr: I<desc_fic> n'est pas un descripteur de fichier valable.

note: type: Plain text
en: I<argp> references an inaccessible memory area.
fr: I<argp> pointe en dehors de l'espace d'adressage valable.

note: type: Plain text
en: I<op> or I<argp> is not valid.
fr: L’I<opération> ou l'argument I<argp> ne sont pas valables.

note: type: Plain text
en: I<fd> is not associated with a character special device.
fr: I<desc_fic> n'est pas associé avec un fichier spécial en mode caractère.

note: type: Plain text
en: The specified operation does not apply to the kind of object that the file descriptor I<fd> references.
fr: L’opération indiquée ne s'applique pas au type d'objet associé avec le descripteur I<desc_fic>.

note: type: Plain text
en: Arguments, returns, and semantics of B<ioctl>()  vary according to the device driver in question (the call is used as a catch-all for operations that don't cleanly fit the UNIX stream I/O model).
fr: Les arguments, les valeurs de retour et la sémantique de B<ioctl>() varient en fonction du pilote de périphérique concerné (cet appel système est utilisé pour encapsuler les opérations qui ne se conforment pas bien au modèle UNIX des entrées/sorties par flux).

note: type: Plain text
en: None.
fr: Aucun.

note: type: SH
en: HISTORY
fr: HISTORIQUE

note: type: Plain text
en: Version\~7 AT&T UNIX has
fr: La version\~7 d’UNIX AT&T a

note: type: Plain text
en: B<ioctl(int >I<fildes>B<, int >I<op>B<, struct sgttyb *>I<argp>B<);>
fr: B<ioctl(int >I<desc_fic>B<, int >I<opération>B<, struct sgttyb *>I<argp>B<);>

note: type: Plain text
en: (where B<struct sgttyb> has historically been used by B<stty>(2)  and B<gtty>(2), and is polymorphic by operation type (like a B<void *> would be, if it had been available)).
fr: où B<struct sgttyb> a historiquement été utilisé par B<stty>(2) et B<gtty>(2) et est polymorphe pour le type d’opération (tel qu’un B<void *> le serait s’il était disponible).

note: type: Plain text
en: SysIII documents I<arg> without a type at all.
fr: SysIII documente I<arg> sans aucun type.

note: type: Plain text
en: 4.3BSD has
fr: 4.3BSD a

note: type: Plain text
en: B<ioctl(int >I<d>B<, unsigned long >I<op>B<, char *>I<argp>B<);>
fr: B<ioctl(int >I<desc_fic>B<, unsigned long >I<opération>B<, char *>I<argp>B<);>

note: type: Plain text
en: (with B<char *> similarly in for B<void *>).
fr: avec B<char *> intégré de façon similaire pour B<void *>.

note: type: Plain text
en: SysVr4 has
fr: SysVr4 a

note: type: Plain text
en: B<int ioctl(int >I<fildes>B<, int >I<op>B<, ... /* >I<arg>B< */);>
fr: B<int ioctl(int >I<desc_fic>B<, int >I<opération>B<, ... /* >I<arg>B< */);>

note: type: Plain text
en: In order to use this call, one needs an open file descriptor.  Often the B<open>(2)  call has unwanted side effects, that can be avoided under Linux by giving it the B<O_NONBLOCK> flag.
fr: Pour utiliser cet appel, on a besoin d'un descripteur de fichier ouvert. Souvent, l'appel B<open>(2) a des effets de bord non désirés, qui peuvent être évités sous Linux en lui passant le drapeau B<O_NONBLOCK>.

note: type: SS
en: ioctl structure
fr: Structure ioctl

note: added two sections - aeb type: Plain text
en: Ioctl I<op> values are 32-bit constants.  In principle these constants are completely arbitrary, but people have tried to build some structure into them.
fr: Les valeurs d’I<opération> ioctl sont des constantes 32 bits. En principe, ces constantes sont totalement arbitraires, mais des gens ont essayé de construire une certaine structure avec elles.

note: type: Plain text
en: The old Linux situation was that of mostly 16-bit constants, where the last byte is a serial number, and the preceding byte(s) give a type indicating the driver.  Sometimes the major number was used: 0x03 for the B<HDIO_*> ioctls, 0x06 for the B<LP*> ioctls.  And sometimes one or more ASCII letters were used.  For example, B<TCGETS> has value 0x00005401, with 0x54 = \[aq]T\[aq] indicating the terminal driver, and B<CYGETTIMEOUT> has value 0x00435906, with 0x43 0x59 = \[aq]C\[aq] \[aq]Y\[aq] indicating the cyclades driver.
fr: Avant, sous Linux, il y avait principalement des constantes de 16 bits, où le dernier octet est un numéro de série et le(s) précédent(s) octet(s) donne(nt) un type indiquant le pilote. Parfois, le nombre majeur était utilisé : 0x03 pour les ioctls B<HDIO_*>, 0x06 pour les ioctls B<LP*>, et parfois, une ou plusieurs lettres ASCII étaient utilisées. Par exemple, B<TCGETS> a une valeur de 0x00005401, avec 0x54 = \[aq]T\[aq] indiquant le pilote du terminal, et B<CYGETTIMEOUT> avait une valeur de 0x00435906, avec 0x43 0x59 = \[aq]C\[aq] \[aq]Y\[aq] indiquant le pilote cyclades.

note: type: Plain text
en: Later (0.98p5) some more information was built into the number.  One has 2 direction bits (00: none, 01: write, 10: read, 11: read/write)  followed by 14 size bits (giving the size of the argument), followed by an 8-bit type (collecting the ioctls in groups for a common purpose or a common driver), and an 8-bit serial number.
fr: Plus tard (0.98p5), des informations supplémentaires ont été construites dans le numéro. L'une a deux bits de direction (00 : aucun, 01 : écriture, 10 : lecture, 11 : lecture/écriture), suivis de 14 bits de taille (donnant la taille de l'argument), suivis d'un autre de type de 8 bits (récupérant les ioctls dans des groupes pour une utilisation générique ou un pilote commun) et d’un numéro de série de 8 bits.

note: type: Plain text
en: The macros describing this structure live in I<E<lt>asm/ioctl.hE<gt>> and are B<_IO(type,nr)> and B<{_IOR,_IOW,_IOWR}(type,nr,size)>.  They use I<sizeof(size)> so that size is a misnomer here: this third argument is a data type.
fr: Les macros décrivant cette structure se trouvent dans I<E<lt>asm/ioctl.hE<gt>>. Il s'agit de B<_IO(type,nr)> et B<{_IOR,_IOW,_IOWR}(type,nr,size)>. Elles utilisent I<sizeof(size)>, donc la taille est ici une appellation inappropriée : ce troisième argument est de type donnée.

note: type: Plain text
en: Note that the size bits are very unreliable: in lots of cases they are wrong, either because of buggy macros using I<sizeof(sizeof(struct))>, or because of legacy values.
fr: Notez que les bits de taille ne sont pas fiables du tout : dans de nombreux cas, ils sont faux, soit du fait de macros boguées qui utilisent I<sizeof(sizeof(struct))>, soit à cause de valeurs patrimoniales.

note: type: Plain text
en: Thus, it seems that the new structure only gave disadvantages: it does not help in checking, but it causes varying values for the various architectures.
fr: Ainsi, il semble que cette nouvelle structure ne procure que des inconvénients : elle n'aide pas à faire des vérifications mais provoque une variation de valeurs sur les différentes architectures.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: TH
en: 2023-02-05
fr: 5 février 2023

note: type: TH
en: Linux man-pages 6.03
fr: Pages du manuel de Linux 6.03

note: POSIX says 'request' is int, but glibc has the above See https://bugzilla.kernel.org/show_bug.cgi?id=42705 type: Plain text
en: B<int ioctl(int >I<fd>B<, unsigned long >I<request>B<, ...);>
fr: B<int ioctl(int >I<desc_fic>B<, unsigned long >I<requête>B<, ...);>

note: type: Plain text
en: The B<ioctl>()  system call manipulates the underlying device parameters of special files.  In particular, many operating characteristics of character special files (e.g., terminals) may be controlled with B<ioctl>()  requests.  The argument I<fd> must be an open file descriptor.
fr: L'appel système B<ioctl>() modifie le comportement des périphériques sous\(hyjacents des fichiers spéciaux. En particulier, de nombreuses caractéristiques des fichiers spéciaux en mode caractère (par exemple des terminaux) peuvent être contrôlées avec des requêtes B<ioctl>(). L'argument I<desc_fic> doit être un descripteur de fichier ouvert.

note: type: Plain text
en: The second argument is a device-dependent request code.  The third argument is an untyped pointer to memory.  It's traditionally B<char *>I<argp> (from the days before B<void *> was valid C), and will be so named for this discussion.
fr: Le second argument est le code de la requête dépendant du périphérique. Le troisième argument est un pointeur non typé. Il est traditionnellement défini en B<char *>I<argp> (cela date de l'époque avant que B<void *> soit du C valable), et sera ainsi nommé dans le reste de cette page.

note: type: Plain text
en: An B<ioctl>()  I<request> has encoded in it whether the argument is an I<in> parameter or I<out> parameter, and the size of the argument I<argp> in bytes.  Macros and defines used in specifying an B<ioctl>()  I<request> are located in the file I<E<lt>sys/ioctl.hE<gt>>.  See NOTES.
fr: Une I<requête> B<ioctl>() encapsule le fait que l'argument est un paramètre d'I<entrée> ou de I<sortie> ainsi que la taille de l'argument I<argp> en octets. Les macros et définitions décrivant une I<requête> B<ioctl>() se trouvent dans le fichier I<E<lt>sys/ioctl.hE<gt>>. Voir NOTES.

note: type: Plain text
en: Usually, on success zero is returned.  A few B<ioctl>()  requests use the return value as an output parameter and return a nonnegative value on success.  On error, -1 is returned, and I<errno> is set to indicate the error.
fr: En général, B<ioctl> renvoie B<0> s'il réussit. Certaines requêtes B<ioctl> utilisent la valeur de retour comme paramètre de sortie, et renvoient une valeur non négative si elles réussissent. En cas d'échec, B<-1> est renvoyé et I<errno> est positionnée pour indiquer l'erreur.

note: type: Plain text
en: I<request> or I<argp> is not valid.
fr: La I<requête> ou l'argument I<argp> n'est pas valide.

note: type: Plain text
en: The specified request does not apply to the kind of object that the file descriptor I<fd> references.
fr: La requête indiquée ne s'applique pas au type d'objet associé avec le descripteur I<desc_fic>.

note: type: Plain text
en: No single standard.  Arguments, returns, and semantics of B<ioctl>()  vary according to the device driver in question (the call is used as a catch-all for operations that don't cleanly fit the UNIX stream I/O model).
fr: Pas de standard unique. Les arguments, les valeurs de retour, et la sémantique de B<ioctl>() varient en fonction du périphérique concerné (cet appel système est utilisé pour encapsuler les opérations qui ne se conforment pas bien au modèle UNIX des entrées/sorties par flux).

note: type: Plain text
en: The B<ioctl>()  system call appeared in Version 7 AT&T UNIX.
fr: L'appel système B<ioctl>() est apparu dans l'UNIX d'AT&T Version 7.

note: added two sections - aeb type: Plain text
en: Ioctl command values are 32-bit constants.  In principle these constants are completely arbitrary, but people have tried to build some structure into them.
fr: Les valeurs de la commande ioctl sont des constantes 32 bits. En principe, ces constantes sont totalement arbitraires, mais des gens ont essayé de construire une certaine structure avec elles.

note: type: TH
en: 2023-10-31
fr: 31 octobre 2023

note: type: TH
en: Linux man-pages 6.06
fr: Pages du manuel de Linux 6.06

note: type: Plain text
en: B<int ioctl(int >I<fd>B<, unsigned long >I<request>B<, ...);>\f[R]  /* glibc, BSD */\fR
    B<int ioctl(int >I<fd>B<, int >I<request>B<, ...);>\f[R]            /* musl, other UNIX */\fR
fr: B<int ioctl(int >I<desc_fic>B<, unsigned long >I<requête>B<, ...);>\f[R]  /* glibc, BSD */\fR
    B<int ioctl(int >I<desc_fic>B<, int >I<requête>B<, ...);>\f[R]            /* musl, autres UNIX */\fR

note: type: Plain text
en: B<ioctl(int >I<fildes>B<, int >I<request>B<, struct sgttyb *>I<argp>B<);>
fr: B<ioctl(int >I<desc_fic>B<, int >I<requête>B<, struct sgttyb *>I<argp>B<);>

note: type: Plain text
en: (where B<struct sgttyb> has historically been used by B<stty>(2)  and B<gtty>(2), and is polymorphic by request type (like a B<void *> would be, if it had been available)).
fr: où B<struct sgttyb> a historiquement été utilisé par B<stty>(2) et B<gtty>(2) et est polymorphe pour le type d’opération (tel qu’un B<void *> le serait s’il était disponible).

note: type: Plain text
en: B<ioctl(int >I<d>B<, unsigned long >I<request>B<, char *>I<argp>B<);>
fr: B<ioctl(int >I<desc_fic>B<, unsigned long >I<requête>B<, char *>I<argp>B<);>

note: type: Plain text
en: B<int ioctl(int >I<fildes>B<, int >I<request>B<, ... /* >I<arg>B< */);>
fr: B<int ioctl(int >I<desc_fic>B<, int >I<requête>B<, ... /* >I<arg>B< */);>

note: type: TH
en: 2023-03-30
fr: 30 mars 2023

note: type: TH
en: Linux man-pages 6.04
fr: Pages du manuel de Linux 6.04

note: type: Plain text
en: Version\~7 AT&T UNIX.
fr: UNIX version\~7 d’AT&T.
