perkamon - en to fr translation catalogue (26 entries)

note: type: TH
en: 2019-03-06
fr: 6 mars 2019

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: backtrace, backtrace_symbols, backtrace_symbols_fd - support for application self-debugging
fr: backtrace, backtrace_symbols, backtrace_symbols_fd - Outils d'auto-débogage d'applications

note: type: Plain text
en: B<backtrace>()  returns a backtrace for the calling program, in the array pointed to by I<buffer>.  A backtrace is the series of currently active function calls for the program.  Each item in the array pointed to by I<buffer> is of type I<void\ *>, and is the return address from the corresponding stack frame.  The I<size> argument specifies the maximum number of addresses that can be stored in I<buffer>.  If the backtrace is larger than I<size>, then the addresses corresponding to the I<size> most recent function calls are returned; to obtain the complete backtrace, make sure that I<buffer> and I<size> are large enough.
fr: B<backtrace>() renvoie une trace des appels du programme dans un tableau pointé par I<buffer>. Une trace est une série d'appels de fonction actuellement actif d'un programme. Chaque élément du tableau pointé par I<buffer> est de type I<void\ *>, et correspond à l'adresse de retour de la «\ stack frame\ » correspondante. Le paramètre I<size> spécifie le nombre maximum d'adresses qui peut être enregistré dans I<buffer>. Si la trace est plus grande que I<size>, alors les adresses correspondant aux I<size> plus récents appels de fonction sont retournées. Pour obtenir une trace complète, soyez sûre que I<buffer> et I<size> sont assez grand.

note: type: Plain text
en: Given the set of addresses returned by B<backtrace>()  in I<buffer>, B<backtrace_symbols>()  translates the addresses into an array of strings that describe the addresses symbolically.  The I<size> argument specifies the number of addresses in I<buffer>.  The symbolic representation of each address consists of the function name (if this can be determined), a hexadecimal offset into the function, and the actual return address (in hexadecimal).  The address of the array of string pointers is returned as the function result of B<backtrace_symbols>().  This array is B<malloc>(3)ed by B<backtrace_symbols>(), and must be freed by the caller.  (The strings pointed to by the array of pointers need not and should not be freed.)
fr: À partir des adresses renvoyées par B<backtrace>() dans le I<buffer>, B<backtrace_symbols>() traduit les adresses en un tableau de chaînes qui donne les symboles associés à ces adresses. Le paramètre I<size> indique le nombre d'adresses dans le I<buffer>. La représentation symbolique de chaque adresse consiste en un nom de fonction (s'il peut être déterminé), un décalage hexadécimal à l'intérieur de la fonction, et l'adresse (hexadécimale) de retour. L'adresse du tableau de chaînes est renvoyé comme résultat de la fonction B<backtrace_symbols>(). Ce tableau est alloué avec B<malloc>(3) par B<backtrace_symbols>() et doit être libéré par l'appelant. Les chaînes pointées par le tableau de pointeurs n'ont pas et ne devraient pas être libérées.

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

note: type: Plain text
en: B<backtrace>()  returns the number of addresses returned in I<buffer>, which is not greater than I<size>.  If the return value is less than I<size>, then the full backtrace was stored; if it is equal to I<size>, then it may have been truncated, in which case the addresses of the oldest stack frames are not returned.
fr: B<backtrace>() fournit le nombre d'adresses renvoyées dans le I<buffer>, qui ne sera pas supérieur à I<size>. Si la valeur de retour est inférieure à I<size>, alors toute la trace a pu être sauvée\ ; si elle est égale à I<size>, alors il se peut qu'elle ait été tronquée et les adresses des trames les plus anciennes sur la pile ne sont pas renvoyées.

note: type: Plain text
en: On success, B<backtrace_symbols>()  returns a pointer to the array B<malloc>(3)ed by the call; on error, NULL is returned.
fr: En cas de succès, B<backtrace_symbols>() renvoie un pointeur vers le tableau alloué avec B<malloc>(3). En cas d'erreur NULL est renvoyé.

note: type: Plain text
en: B<backtrace>(), B<backtrace_symbols>(), and B<backtrace_symbols_fd>()  are provided in glibc since version 2.1.
fr: B<backtrace>(), B<backtrace_symbols>() et B<backtrace_symbols_fd>() sont fournies par la glibc depuis la version 2.1.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: tbl table
en: Value
fr: Valeur

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

note: type: Plain text
en: These functions are GNU extensions.
fr: Ces fonctions sont des extensions GNU.

note: type: Plain text
en: These functions make some assumptions about how a function's return address is stored on the stack.  Note the following:
fr: Ces fonctions font des suppositions sur la façon dont l'adresse de retour d'une fonction est sauvegardée dans la pile. Prenez note des points suivants\ :

note: type: Plain text
en: Omission of the frame pointers (as implied by any of B<gcc>(1)'s nonzero optimization levels) may cause these assumptions to be violated.
fr: L'omission du pointeur de trame (comme le fait B<gcc>(1) avec les niveaux d'optimisation différents de zéro) peut être incompatible avec ces suppositions.

note: type: Plain text
en: Inlined functions do not have stack frames.
fr: Les fonctions en lignes («\ inline\ ») n'apparaissent pas sur la pile.

note: type: Plain text
en: Tail-call optimization causes one stack frame to replace another.
fr: Avec les optimisations de type Tail-call une trame sur la pile peut être remplacée par une autre.

note: type: Plain text
en: The symbol names may be unavailable without the use of special linker options.  For systems using the GNU linker, it is necessary to use the I<-rdynamic> linker option.  Note that names of "static" functions are not exposed, and won't be available in the backtrace.
fr: Le nom des symboles peut ne pas être disponible si certaines options de l'éditeur de liens n'ont pas été utilisées. Pour les systèmes qui utilisent l'éditeur de liens GNU, il faut utiliser l'option I<-rdynamic>. Notez que les noms des fonctions statiques (avec le mot clef «\ static\ ») ne sont pas exposés, et ne seront pas disponibles pour la trace.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The program below demonstrates the use of B<backtrace>()  and B<backtrace_symbols>().  The following shell session shows what we might see when running the program:
fr: Le programme ci-dessous explique l'utilisation de B<backtrace>() et B<backtrace_symbols>(). Les sessions d'interpréteur de commandes montrent ce que produira l'exécution du programme\ :

note: type: SS
en: Program source
fr: Source du programme

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/.
