perkamon - en to fr translation catalogue (56 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: getaddrinfo_a, gai_suspend, gai_error, gai_cancel - asynchronous network address and service translation
fr: getaddrinfo_a, gai_suspend, gai_error, gai_cancel - Traduction asynchrone d'adresses et de services réseau

note: type: Plain text
en: B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */
    B<#include E<lt>netdb.hE<gt>>
fr: B<#define _GNU_SOURCE>         /* Consultez feature_test_macros(7) */
    B<#include E<lt>netdb.hE<gt>>

note: type: Plain text
en: Link with I<-lanl>.
fr: Effectuez l'édition des liens avec l'option I<-lanl>.

note: type: Plain text
en: The B<getaddrinfo_a>()  function performs the same task as B<getaddrinfo>(3), but allows multiple name look-ups to be performed asynchronously, with optional notification on completion of look-up operations.
fr: La fonction B<getaddrinfo_a>() effectue la même opération que B<getaddrinfo>(3), mais permet d'effectuer plusieurs résolutions de manière asynchrone et de recevoir une notification à chaque résolution effectuée.

note: type: Plain text
en: The I<mode> argument has one of the following values:
fr: Le champ I<mode> peut prendre une des valeurs suivantes\ :

note: type: Plain text
en: Perform the look-ups synchronously.  The call blocks until the look-ups have completed.
fr: Effectue les résolutions de manière synchrone. L'appel bloque tant que les résolutions ne sont pas terminées.

note: type: Plain text
en: Perform the look-ups asynchronously.  The call returns immediately, and the requests are resolved in the background.  See the discussion of the I<sevp> argument below.
fr: Effectue les résolutions de manière asynchrone. L'appel s'achève immédiatement et les requêtes sont résolues en arrière-plan. Consultez la description du paramètre I<sevp> ci-dessous.

note: type: Plain text
en: The array I<list> specifies the look-up requests to process.  The I<nitems> argument specifies the number of elements in I<list>.  The requested look-up operations are started in parallel.  NULL elements in I<list> are ignored.  Each request is described by a I<gaicb> structure, defined as follows:
fr: Le tableau I<list> indique les requêtes de recherche à traiter. Le paramètre I<nitems> indique le nombre d'éléments dans I<list>. Les opérations de recherche demandées sont lancées en parallèle. Les éléments égal à NULL de I<list> sont ignorés. Chaque requête est décrite par une structure I<gaicb> définie ci-dessous\ :

note: type: Plain text
en: The elements of this structure correspond to the arguments of B<getaddrinfo>(3).  Thus, I<ar_name> corresponds to the I<node> argument and I<ar_service> to the I<service> argument, identifying an Internet host and a service.  The I<ar_request> element corresponds to the I<hints> argument, specifying the criteria for selecting the returned socket address structures.  Finally, I<ar_result> corresponds to the I<res> argument; you do not need to initialize this element, it will be automatically set when the request is resolved.  The I<addrinfo> structure referenced by the last two elements is described in B<getaddrinfo>(3).
fr: Les éléments de cette structure correspondent aux paramètres de B<getaddrinfo>(3). Ainsi, I<ar_name> correspond au paramètre I<node> et I<ar_service> au paramètre I<service>, identifiant respectivement un hôte et un service Internet. L'élément I<ar_request> correspond au paramètre I<hints>, indiquant le critère de sélection des structures d'adresse de socket renvoyées. Enfin, I<ar_result> correspond au paramètre I<res>\ ; vous n'avez pas besoin d'initialiser ce paramètre, il sera automatiquement défini lorsque la requête sera résolue. La structure I<addrinfo> référencée par les deux derniers éléments est décrite dans B<getaddrinfo>(3).

note: type: Plain text
en: When I<mode> is specified as B<GAI_NOWAIT>, notifications about resolved requests can be obtained by employing the I<sigevent> structure pointed to by the I<sevp> argument.  For the definition and general details of this structure, see B<sigevent>(7).  The I<sevp-E<gt>sigev_notify> field can have the following values:
fr: Lorsque I<mode> est défini à B<GAI_NOWAIT>, les notifications des requêtes résolues peuvent être obtenues avec la structure I<sigevent> pointée par le paramètre I<sevp>. Pour la définition et les détails généraux de cette structure, consultez B<sigevent>(7). Le champ I<sevp-E<gt>sigev_notify> peut prendre l'une des valeurs suivantes\ :

note: type: Plain text
en: Don't provide any notification.
fr: Ne fournit pas de notification.

note: si_pid and si_uid are also set, to the values of the calling process, which doesn't provide useful information, so we'll skip mentioning it. type: Plain text
en: When a look-up completes, generate the signal I<sigev_signo> for the process.  See B<sigevent>(7)  for general details.  The I<si_code> field of the I<siginfo_t> structure will be set to B<SI_ASYNCNL>.
fr: Lorsqu'une recherche se termine, générer le signal I<sigev_signo> à destination du processus. Consultez B<sigevent>(7) pour plus de détails. Le champ I<si_code> de la structure I<siginfo_t> sera défini à B<SI_ASYNCNL>.

note: type: Plain text
en: When a look-up completes, invoke I<sigev_notify_function> as if it were the start function of a new thread.  See B<sigevent>(7)  for details.
fr: Lors d'une résolution, invoquer I<sigev_notify_function> comme si c'était la fonction de création d'un nouveau processus léger. Consultez B<sigevent>(7) pour plus détails.

note: type: Plain text
en: For B<SIGEV_SIGNAL> and B<SIGEV_THREAD>, it may be useful to point I<sevp-E<gt>sigev_value.sival_ptr> to I<list>.
fr: Pour B<SIGEV_SIGNAL> et B<SIGEV_THREAD>, il peut être utile de faire pointer I<sevp-E<gt>sigev_value.sival_ptr> vers I<list>.

note: type: Plain text
en: The B<gai_suspend>()  function suspends execution of the calling thread, waiting for the completion of one or more requests in the array I<list>.  The I<nitems> argument specifies the size of the array I<list>.  The call blocks until one of the following occurs:
fr: La fonction B<gai_suspend>() suspend l'exécution du processus léger appelant, attendant la fin d'une ou plusieurs requêtes du tableau I<list>. L'argument I<nitems> indique la taille du tableau I<list>. L'appel est bloquant tant que l'un des événements suivants ne se produisent :

note: type: Plain text
en: One or more of the operations in I<list> completes.
fr: Une ou plusieurs des opérations de I<list> se sont terminées.

note: type: Plain text
en: The call is interrupted by a signal that is caught.
fr: L'appel a été interrompu par un signal qui a été interrompu.

note: type: Plain text
en: The time interval specified in I<timeout> elapses.  This argument specifies a timeout in seconds plus nanoseconds (see B<nanosleep>(2)  for details of the I<timespec> structure).  If I<timeout> is NULL, then the call blocks indefinitely (until one of the events above occurs).
fr: L'intervalle de temps indiqué dans I<timeout> s'est écoulé. Ce paramètre indique un délai en seconds plus nanosecondes (consultez B<nanosleep>(2) pour plus de détails sur la structure I<timespec>). Si I<timeout> est NULL, alors l'appel est bloqué indéfiniment (à moins que l'un des événement ci-dessus se produisent).

note: type: Plain text
en: No explicit indication of which request was completed is given; you must determine which request(s) have completed by iterating with B<gai_error>()  over the list of requests.
fr: Aucune indication explicite sur la requête qui s'est terminée est fournie\ ; vous devez déterminer quelle requête s'est terminée en parcourant avec B<gai_error>() la liste des requête (il peut y avoir plusieurs requêtes).

note: type: Plain text
en: The B<gai_error>()  function returns the status of the request I<req>: either B<EAI_INPROGRESS> if the request was not completed yet, 0 if it was handled successfully, or an error code if the request could not be resolved.
fr: La fonction B<gai_error>() renvoie l'état de la requête I<req>\ : soit B<EAI_INPROGRESS> si la requête ne s'est pas encore terminée, soit 0 si elle s'est terminé correctement ou soit un code d'erreur si elle ne peut pas être résolue.

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

note: type: Plain text
en: The B<getaddrinfo_a>()  function returns 0 if all of the requests have been enqueued successfully, or one of the following nonzero error codes:
fr: La fonction B<getaddrinfo_a>() renvoie 0 si toutes les requêtes ont été mises en file d'attente avec succès, ou un des codes d'erreur non nuls suivants\ :

note: type: Plain text
en: The resources necessary to enqueue the look-up requests were not available.  The application may check the error status of each request to determine which ones failed.
fr: Les ressources nécessaires pour mettre en file d'attente les requêtes de recherche ne sont pas disponibles. L'application devrait vérifier le statut d'erreur de chaque requête pour déterminer laquelle a échoué.

note: type: Plain text
en: Out of memory.
fr: Plus de mémoire disponible.

note: type: Plain text
en: I<mode> is invalid.
fr: I<mode> est non valable.

note: type: Plain text
en: The B<gai_suspend>()  function returns 0 if at least one of the listed requests has been completed.  Otherwise, it returns one of the following nonzero error codes:
fr: La fonction B<gai_suspend>() renvoie 0 si au moins une des requêtes listées s'est terminée. Sinon, elle renvoie un des codes d'erreur non nuls suivants\ :

note: type: Plain text
en: The given timeout expired before any of the requests could be completed.
fr: Le délai d'attente a expiré avant que toute requête ne soit terminée.

note: type: Plain text
en: There were no actual requests given to the function.
fr: Il n'y a actuellement aucune requête fournie à la fonction.

note: type: Plain text
en: A signal has interrupted the function.  Note that this interruption might have been caused by signal notification of some completed look-up request.
fr: Un signal a interrompu la fonction. Notez que cette interruption pourrait avoir été causé par une notification de signal de fin de certaines requêtes de recherche.

note: type: Plain text
en: The B<gai_cancel>()  function can return one of these values:
fr: La fonction B<gai_cancel>() peut renvoyer une des valeurs suivantes :

note: type: Plain text
en: The request has been canceled successfully.
fr: La requête a été annulée avec succès.

note: type: Plain text
en: The request has not been canceled.
fr: La requête n'a pas été annulée.

note: type: Plain text
en: The request has already completed.
fr: La requête est déjà terminée.

note: type: Plain text
en: The B<gai_strerror>(3)  function translates these error codes to a human readable string, suitable for error reporting.
fr: La fonction B<gai_strerror>(3) traduit ces codes d'erreur en une chaîne de caractères compréhensible, utilisable pour rendre compte du problème.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: Plain text
en: For an explanation of the terms used in this section, see B<attributes>(7).
fr: Pour une explication des termes utilisés dans cette section, consultez B<attributes>(7).

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; they first appeared in glibc in version 2.2.3.
fr: Ces fonctions sont des extensions GNU. Elles ont été introduites dans la glibc dans sa version 2.1.1.

note: type: Plain text
en: The interface of B<getaddrinfo_a>()  was modeled after the B<lio_listio>(3)  interface.
fr: L'interface de B<getaddrinfo_a>() a été modifiée après l'interface B<lio_listio>(3).

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: Two examples are provided: a simple example that resolves several requests in parallel synchronously, and a complex example showing some of the asynchronous capabilities.
fr: Deux exemples sont fournis\ : un simple exemple qui résout plusieurs requête en parallèle de façon synchrone et un exemple complexe montrant certaines des capacités asynchrones.

note: type: SS
en: Synchronous example
fr: Exemple synchrone

note: type: Plain text
en: The program below simply resolves several hostnames in parallel, giving a speed-up compared to resolving the hostnames sequentially using B<getaddrinfo>(3).  The program might be used like this:
fr: Le programme ci-dessous résout simplement plusieurs noms d'hôte en parallèle, améliorant le temps de résolution des noms d'hôtes comparé à des appels séquentiels à B<getaddrinfo>(3). Le programme peut être utilisé comme suit\ :

note: type: Plain text
en: Here is the program source code
fr: Voilà le code source du programme

note: type: SS
en: Asynchronous example
fr: Exemple asynchrone

note: type: Plain text
en: This example shows a simple interactive B<getaddrinfo_a>()  front-end.  The notification facility is not demonstrated.
fr: Cet exemple est une simple application interactive utilisant B<getaddrinfo_a>(). Les fonctionnalités de notification ne sont pas exploitées.

note: type: Plain text
en: An example session might look like this:
fr: Un exemple de session pourrait ressembler à ceci\ :

note: type: Plain text
en: The program source is as follows:
fr: Le code source du programme est\ :

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