perkamon - en to fr translation catalogue (49 entries)

note: type: TH
en: 2017-09-15
fr: 15 septembre 2017

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: syslog, klogctl - read and/or clear kernel message ring buffer; set console_loglevel
fr: syslog, klogctl - Lire et/ou effacer les tampons circulaires de messages du noyau

note: type: Plain text
en: B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>
    B</* No wrapper provided in glibc */>
fr: B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>
    B</* Pas de fonction fournie par glibc */>

note: type: Plain text
en: I<Note>: Probably, you are looking for the C library function B<syslog>(), which talks to B<syslogd>(8); see B<syslog>(3)  for details.
fr: I<Note> : vous cherchez sans doute la fonction de la bibliothèque C B<syslog>() qui communique avec   B<syslogd>(8) ; reportez-vous à B<syslog>(3) pour plus de détails.

note: type: Plain text
en: This page describes the kernel B<syslog>()  system call, which is used to control the kernel I<printk>()  buffer; the glibc wrapper function for the system call is called B<klogctl>().
fr: Cette page décrit l'appel système du noyau B<syslog>() qui est utilisé pour contrôler le tampon du noyau I<printk>() ; la fonction d'encapsulation de glibc correspondant à cet appel système est  B<klogctl>().

note: type: SS
en: The kernel log buffer
fr: Le tampon de journalisation du noyau.

note: Under "General setup" ==> "Kernel log buffer size" For 2.6, precisely the option seems to have appeared in 2.5.55. type: Plain text
en: The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages given as arguments to the kernel function B<printk>()  are stored (regardless of their log level).  In early kernels, B<LOG_BUF_LEN> had the value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113, it was 16384; since kernel 2.4.23/2.6, the value is a kernel configuration option (B<CONFIG_LOG_BUF_SHIFT>, default value dependent on the architecture).  Since Linux 2.6.6, the size can be queried with command type 10 (see below).
fr: Le noyau dispose d'un tampon circulaire d'une longueur B<LOG_BUF_LEN> dans lequel il stocke les messages fournis en paramètre à la fonction du noyau B<printk>() (sans tenir compte du niveau de journalisation). Dans les premiers noyaux, B<LOG_BUF_LEN> avait pour valeur 4096 ; à partir du noyau 1.3.54 elle valait 8192 ; à partir du noyau 2.1.113 elle valait 16384 ; depuis le noyau 2.4.23/2.6 la valeur est une option de configuration du noyau (B<CONFIG_LOG_BUF_SHIFT>, valeur par défaut dépendant de l'architecture). Depuis Linux 2.6.6, la commande de type 10 (voir plus bas) renvoie la taille du tampon.

note: type: SS
en: Commands
fr: Commandes

note: type: Plain text
en: The I<type> argument determines the action taken by this function.  The list below specifies the values for I<type>.  The symbolic names are defined in the kernel source, but are not exported to user space; you will either need to use the numbers, or define the names yourself.
fr: L'argument I<type> détermine quelle action est réalisée par cette fonction. La liste ci-dessous précise les valeurs que peut prendre I<type>. Les noms symboliques sont définis dans les sources du noyau, mais ne sont pas exportés dans l'environnement utilisateur ; vous devrez donc utiliser les identifiants numériques, ou redéfinir vous même les noms.

note: type: Plain text
en: Close the log.  Currently a NOP.
fr: Ferme le journal. Actuellement, cette instruction est sans effet.

note: type: Plain text
en: Open the log.  Currently a NOP.
fr: Ouvre le journal. Actuellement, cette instruction est sans effet.

note: type: Plain text
en: Read from the log.  The call waits until the kernel log buffer is nonempty, and then reads at most I<len> bytes into the buffer pointed to by I<bufp>.  The call returns the number of bytes read.  Bytes read from the log disappear from the log buffer: the information can be read only once.  This is the function executed by the kernel when a user program reads I</proc/kmsg>.
fr: Lecture du journal. Dès que le tampon du journal  n'est plus vide, l'appel lit au plus I<len> octets qu'il place dans le tampon vers lequel pointe I<buf>. Il renvoie le nombre d'octets lus. Les octets lus sont supprimés du journal\ : les informations ne peuvent être lues qu'une seule fois. C'est la fonction exécutée par le noyau quand un programme utilisateur lit I</proc/kmsg>.

note: type: Plain text
en: Read all messages remaining in the ring buffer, placing them in the buffer pointed to by I<bufp>.  The call reads the last I<len> bytes from the log buffer (nondestructively), but will not read more than was written into the buffer since the last "clear ring buffer" command (see command 5 below)).  The call returns the number of bytes read.
fr: Lecture de tous les messages restant dans le tampon circulaire, qui sont déplacés dans le tampon vers lequel pointe I<bufp>. L'appel lit les I<len> derniers octets dans le journal (de manière non destructive). Il ne lira pas plus que ce qui a été écrit dans le tampon depuis la dernière exécution de la commande de nettoyage (commande « clear ring buffer », voir plus bas commande 5). L'appel renvoie le nombre d'octets lus.

note: type: Plain text
en: Read and clear all messages remaining in the ring buffer.  The call does precisely the same as for a I<type> of 3, but also executes the "clear ring buffer" command.
fr: Lecture et suppression de tous les messages du tampon circulaire. L'appel effectue exactement la même chose que la commande de I<type> 3, mais exécute également la commande « clear ring buffer ».

note: type: Plain text
en: The call executes just the "clear ring buffer" command.  The I<bufp> and I<len> arguments are ignored.
fr: L'appel ne fait qu'exécuter la commande « clear ring buffer ». Les arguments  I<bufp> and I<len> ne sont pas pris en compte.

note: type: Plain text
en: This command does not really clear the ring buffer.  Rather, it sets a kernel bookkeeping variable that determines the results returned by commands 3 (B<SYSLOG_ACTION_READ_ALL>)  and 4 (B<SYSLOG_ACTION_READ_CLEAR>).  This command has no effect on commands 2 (B<SYSLOG_ACTION_READ>)  and 9 (B<SYSLOG_ACTION_SIZE_UNREAD>).
fr: Cette fonction ne vide pas réellement le tampon circulaire. Plus exactement, elle définit une variable de suivi d'activité du noyau qui détermine ce que renvoient les commandes 3 (B<SYSLOG_ACTION_READ_ALL>) et 4 (B<SYSLOG_ACTION_READ_CLEAR>). Cette commande est sans effet sur les commandes 2 (B<SYSLOG_ACTION_READ>) et 9 (B<SYSLOG_ACTION_SIZE_UNREAD>).

note: commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245 type: Plain text
en: The command saves the current value of I<console_loglevel> and then sets I<console_loglevel> to I<minimum_console_loglevel>, so that no messages are printed to the console.  Before Linux 2.6.32, the command simply sets I<console_loglevel> to I<minimum_console_loglevel>.  See the discussion of I</proc/sys/kernel/printk>, below.
fr: La commande sauvegarde la valeur actuelle de I<console_loglevel> puis affecte la valeur I<minimum_console_loglevel> à I<console_loglevel> afin que les messages soient affichés sur la console. Avant Linux 2.6.32, la commande affectait seulement la valeur I<minimum_console_loglevel> à I<console_loglevel>. Reportez-vous aux explications relatives à I</proc/sys/kernel/printk> plus bas.

note: type: Plain text
en: The I<bufp> and I<len> arguments are ignored.
fr: Les arguments  I<bufp> and I<len> ne sont pas pris en compte.

note: commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245 type: Plain text
en: If a previous B<SYSLOG_ACTION_CONSOLE_OFF> command has been performed, this command restores I<console_loglevel> to the value that was saved by that command.  Before Linux 2.6.32, this command simply sets I<console_loglevel> to I<default_console_loglevel>.  See the discussion of I</proc/sys/kernel/printk>, below.
fr: Si la commande B<SYSLOG_ACTION_CONSOLE_OFF> a été exécutée précédemment, cette commande réaffecte à I<console_loglevel> la valeur sauvegardée au moment de cette exécution. Avant Linux 2.6.32, cette commande réaffectait la valeur I<default_console_loglevel> à I<console_loglevel>. Reportez-vous aux explications relatives à I</proc/sys/kernel/printk> plus bas.

note: type: Plain text
en: The call sets I<console_loglevel> to the value given in I<len>, which must be an integer between 1 and 8 (inclusive).  The kernel silently enforces a minimum value of I<minimum_console_loglevel> for I<len>.  See the I<log level> section for details.  The I<bufp> argument is ignored.
fr: L'appel positionne I<console_loglevel> à la valeur indiquée dan I<len>, qui doit être un entier compris entre 1 et 8 (inclus). Le noyau applique implicitement une valeur minimum I<minimum_console_loglevel> pour I<len> Consultez la section B<Le niveau de journalisation (log level)> pour plus de détails. Les arguments I<bufp> et I<len> ne sont pas pris en compte.

note: type: TP
en: B<SYSLOG_ACTION_SIZE_UNREAD> (9) (since Linux 2.4.10)
fr: B<SYSLOG_ACTION_SIZE_UNREAD> (9) (à partir de Linux 2.4.10)

note: type: Plain text
en: The call returns the number of bytes currently available to be read from the kernel log buffer via command 2 (B<SYSLOG_ACTION_READ>).  The I<bufp> and I<len> arguments are ignored.
fr: L'appel renvoie le nombre d'octets disponibles en lecture dans le tampon de journalisation du noyau au moment de l'appel, au moyen de la commande 2 (B<SYSLOG_ACTION_READ>). Les arguments I<bufp> et I<len> ne sont pas pris en compte.

note: type: TP
en: B<SYSLOG_ACTION_SIZE_BUFFER> (10) (since Linux 2.6.6)
fr: B<SYSLOG_ACTION_SIZE_BUFFER> (10) (à partir de Linux 2.6.6)

note: type: Plain text
en: This command returns the total size of the kernel log buffer.  The I<bufp> and I<len> arguments are ignored.
fr: Cette commande renvoie la taille totale du tampon du journal du noyau. Les arguments  I<bufp> et I<len> ne sont pas pris en compte.

note: type: Plain text
en: All commands except 3 and 10 require privilege.  In Linux kernels before 2.6.37, command types 3 and 10 are allowed to unprivileged processes; since Linux 2.6.37, these commands are allowed to unprivileged processes only if I</proc/sys/kernel/dmesg_restrict> has the value 0.  Before Linux 2.6.37, "privileged" means that the caller has the B<CAP_SYS_ADMIN> capability.  Since Linux 2.6.37, "privileged" means that the caller has either the B<CAP_SYS_ADMIN> capability (now deprecated for this purpose) or the (new)  B<CAP_SYSLOG> capability.
fr: Toutes les commandes, excepté 3 et 10, nécessitent des privilèges. Dans les noyaux Linux précédant la version 2.6.37, seules les commandes de type 3 à 10 étaient permises aux processus non privilégiés ; depuis Linux 2.6.37, les commandes de type 3 et 10 sont permises à ces processus seulement si I</proc/sys/kernel/dmesg_restrict> vaut 0. Avant Linux 2.6.37, « privilégié » signifiait que le processus avait soit la capacité B<CAP_SYS_ADMIN> (maintenant obsolète pour cet usage), soit la (nouvelle) capacité B<CAP_SYSLOG>.

note: type: Plain text
en: I</proc/sys/kernel/printk> is a writable file containing four integer values that influence kernel I<printk()> behavior when printing or logging error messages.  The four values are:
fr: I</proc/sys/kernel/printk> est un fichier accessible en écriture qui contient quatre valeurs qui affectent le comportement la fonction I<printk()> du noyau lors de l'affichage ou de la journalisation des messages d'erreur. Ces quatre valeur sont :

note: commit 5af5bcb8d37f99ba415a1adc6da71051b84f93a5 type: Plain text
en: This value will be used as the log level for I<printk()> messages that do not have an explicit level.  Up to and including Linux 2.6.38, the hard-coded default value for this field was 4 (B<KERN_WARNING>); since Linux 2.6.39, the default value is a defined by the kernel configuration option B<CONFIG_DEFAULT_MESSAGE_LOGLEVEL>, which defaults to 4.
fr: Cette valeur fournira le niveau de journalisation des messages de I<printk()> pour lesquels un niveau de journalisation n'est pas explicitement défini. Jusqu'à Linux 2.6.38 inclus, la valeur par défaut inscrite dans le code pour pour ce champ était 4 (B<KERN_WARNING>) ; à partir de Linux 2.6.39, la valeur par défaut est déterminée par l'option de configuration du noyau B<CONFIG_DEFAULT_MESSAGE_LOGLEVEL>, qui par défaut vaut 4.

note: type: Plain text
en: The value in this field is the minimum value to which I<console_loglevel> can be set.
fr: Ce champ contient la valeur minimum qui peut être affectée à I<console_loglevel>.

note: type: Plain text
en: This is the default value for I<console_loglevel>.
fr: La valeur par défaut de I<console_loglevel>.

note: type: SS
en: The log level
fr: Le niveau de journalisation (log level)

note: type: Plain text
en: Every I<printk>()  message has its own log level.  If the log level is not explicitly specified as part of the message, it defaults to I<default_message_loglevel>.  The conventional meaning of the log level is as follows:
fr: Chaque message de I<printk>() a son propre niveau de journalisation. Si le niveau de journalisation n'est pas explicitement précisé comme partie du message, il vaut par défaut I<default_message_loglevel>. Le niveau de journalisation a par convention les significations suivantes :

note: type: Plain text
en: The kernel I<printk()> routine will print a message on the console only if it has a log level less than the value of I<console_loglevel>.
fr: La routine du noyau I<printk()> n'affiche un message sur la console que si son niveau de journalisation est inférieure à la valeur I<console_loglevel>.

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of bytes currently available to be read on the kernel log buffer.  For I<type> 10, B<syslog>()  returns the total size of the kernel log buffer.  For other values of I<type>, 0 is returned on success.
fr: Quand I<type> est égal à 2, 3 ou 4, un appel réussi à B<syslog>() renvoie le nombre d'octets lus. Pour le I<type> 9, B<syslog>() renvoie le nombre d'octets disponibles actuellement en lecture dans le tampon de journalisation du noyau. Pour le I<type> 10, B<syslog>() renvoie la taille totale du tampon de journalisation du noyau. Pour les autres valeurs de I<type>, 0 est renvoyé en cas de succès.

note: type: Plain text
en: In case of error, -1 is returned, and I<errno> is set to indicate the error.
fr: En cas d'erreur, -1 est renvoyé et I<errno> contient le code d'erreur.

note: type: SH
en: ERRORS
fr: ERREURS

note: type: Plain text
en: Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, or I<len> is less than zero; or for I<type> 8, the I<level> is outside the range 1 to 8).
fr: Mauvais paramètres (par exemple, mauvais I<type> ; ou I<type> égal à 2, 3 ou 4 et I<buf> est NULL, ou I<len> est inférieur à 0 ; ou pour I<type> égal à 8, le niveau I<level> est en dehors de l'intervalle allant de 1 à 8).

note: type: Plain text
en: This B<syslog>()  system call is not available, because the kernel was compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled.
fr: L'appel système B<syslog>() n'est pas disponible car le noyau a été compilé sans que l'option B<CONFIG_PRINTK> de configuration du noyau n'ait été activée.

note: type: Plain text
en: An attempt was made to change I<console_loglevel> or clear the kernel message ring buffer by a process without sufficient privilege (more precisely: without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability).
fr: Un changement de I<console_loglevel> ou un effacement du tampon circulaire du noyau par un processus sans les privilèges suffisants (plus précisément sans la capacité B<CAP_SYS_ADMIN> ou B<CAP_SYSLOG>) a été tenté.

note: type: Plain text
en: System call was interrupted by a signal; nothing was read.  (This can be seen only during a trace.)
fr: L'appel système a été interrompu par un signal, et rien n'a été lu. (Ceci ne peut être vu que pendant un suivi de processus).

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: type: Plain text
en: This system call is Linux-specific and should not be used in programs intended to be portable.
fr: Cet appel système est spécifique à Linux et ne devrait pas être employé dans des programmes destinés à être portables.

note: In libc4 and libc5 the number of this call was defined by .BR SYS_klog . In glibc 2.0 the syscall is baptized .BR klogctl (). type: Plain text
en: From the very start, people noted that it is unfortunate that a system call and a library routine of the same name are entirely different animals.
fr: Depuis longtemps, des gens trouvent regrettable qu'un appel système et une routine de bibliothèque aient le même nom bien qu'ils n'aient pas de rapport entre eux.

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

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/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%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/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%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/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
