manpages-fr-extra-util-linux - en to fr translation catalogue (59 entries)

note: type: TH
en: December 2014
fr: Décembre 2014

note: type: TH
en: User Commands
fr: Commandes de l'utilisateur

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: getopt - parse command options (enhanced)
fr: getopt - Analyser des options de lignes de commandes (version améliorée)

note: type: Plain text
en: B<getopt> I<optstring parameters>
fr: B<getopt> I<chaîne_options paramètres>

note: type: Plain text
en: B<getopt> [options] [B<-->] I<optstring parameters>
fr: B<getopt> [I<options>] [B<-->] I<chaîne_options paramètres>

note: type: Plain text
en: B<getopt> [options] B<-o>|B<--options> I<optstring> [options] [B<-->] I<parameters>
fr: B<getopt> [I<options>] B<-o>|B<--options> I<chaîne_options> [I<options>] [B<-->] I<paramètres>

note: type: Plain text
en: The parameters B<getopt> is called with can be divided into two parts: options which modify the way B<getopt> will do the parsing (the I<options> and the I<optstring> in the B<SYNOPSIS>), and the parameters which are to be parsed (I<parameters> in the B<SYNOPSIS>).  The second part will start at the first non-option parameter that is not an option argument, or after the first occurrence of 'B<-->'.  If no 'B<-o>' or 'B<--options>' option is found in the first part, the first parameter of the second part is used as the short options string.
fr: Les paramètres fournis à B<getopt> sont de deux types : le premier type de paramètre est constitué des options qui modifient la façon dont B<getopt> fera l'analyse (les I<options> et I<chaîne_options> dans le B<SYNOPSIS>) et les paramètres à analyser (I<paramètres> dans le B<SYNOPSIS>). Le second type de paramètre commence dès le premier paramètre qui n'est pas une option ou après la première apparition de « B<--> ». Si aucune option « B<-o> » ou « B<--options> » n'est présente dans la première partie, le premier paramètre de la seconde partie sera utilisé comme chaîne d’options courtes.

note: type: Plain text
en: If the environment variable B<GETOPT_COMPATIBLE> is set, or if the first I<parameter> is not an option (does not start with a 'B<->', the first format in the B<SYNOPSIS>), B<getopt> will generate output that is compatible with that of other versions of B<getopt>(1).  It will still do parameter shuffling and recognize optional arguments (see section B<COMPATIBILITY> for more information).
fr: Si la variable d'environnement B<GETOPT_COMPATIBLE> est positionnée, ou si le premier I<paramètre> n'est pas une option (c'est-à-dire ne commence pas par un « B<-> », le premier format du B<SYNOPSIS>), B<getopt> produira une sortie compatible avec d'autres versions de B<getopt>(1). Il réorganisera encore les paramètres et reconnaîtra les paramètres optionnels (consultez la section B<COMPATIBILITÉ> pour plus d'informations).

note: type: Plain text
en: Traditional implementations of B<getopt>(1)  are unable to cope with whitespace and other (shell-specific)  special characters in arguments and non-option parameters.  To solve this problem, this implementation can generate quoted output which must once again be interpreted by the shell (usually by using the B<eval> command).  This has the effect of preserving those characters, but you must call B<getopt> in a way that is no longer compatible with other versions (the second or third format in the B<SYNOPSIS>).  To determine whether this enhanced version of B<getopt>(1)  is installed, a special test option (B<-T>)  can be used.
fr: Les implémentations traditionnelles de B<getopt>(1) ne gèrent pas les espaces ou autres caractères spéciaux (spécifiques à chaque interpréteur de commandes) dans les paramètres (options ou non). Pour résoudre ce problème, cette implémentation peut produire une sortie, avec guillemets, qui doit être interprétée de nouveau par l'interpréteur de commandes (en général avec la commande B<eval>). Cela permet de préserver ces caractères, mais vous devez appeler B<getopt> d'une façon non compatible avec les autres versions (la deuxième ou troisième forme dans le B<SYNOPSIS>). Pour déterminer si cette version améliorée de B<getopt>(1) est installée, vous pouvez utiliser l'option spéciale de test (B<-T>).

note: type: Plain text
en: Allow long options to start with a single 'B<->'.
fr: Permettre aux options longues de ne commencer que par un seul « B<-> ».

note: type: Plain text
en: Display help text and exit.  No other output is generated.
fr: Afficher un texte d’aide puis quitter. Rien d'autre ne sera affiché.

note: type: TP
en: B<-l>,B< --longoptions >I<longopts>
fr: B<-l>,B< --longoptions >I<options_longues>

note: type: Plain text
en: The long (multi-character) options to be recognized.  More than one option name may be specified at once, by separating the names with commas.  This option may be given more than once, the I<longopts> are cumulative.  Each long option name in I<longopts> may be followed by one colon to indicate it has a required argument, and by two colons to indicate it has an optional argument.
fr: Les options longues (plusieurs caractères) à reconnaître. Plusieurs noms d'option peuvent être fournis en une seule fois, en séparant les noms par des virgules. Cette option peut être fournie plusieurs fois, les I<options_longues> se cumulent. Chaque nom d'option dans I<options_longues> peut être suivi d'un deux-points pour indiquer que l'option attend un paramètre, et par deux signes deux-points pour indiquer qu'elle a un paramètre optionnel.

note: type: TP
en: B<-n>,B< --name >I<progname>
fr: B<-n>,B< --name >I<nom-de-programme>

note: type: Plain text
en: The name that will be used by the B<getopt>(3)  routines when it reports errors.  Note that errors of B<getopt>(1)  are still reported as coming from getopt.
fr: Le nom qui sera utilisé par B<getopt>(3) pour signaler les erreurs. Notez que les erreurs de B<getopt>(1) sont signalées comme provenant de B<getopt>.

note: type: TP
en: B<-o>,B< --options >I<shortopts>
fr: B<-o>,B< --options >I<options_courtes>

note: type: Plain text
en: The short (one-character) options to be recognized.  If this option is not found, the first parameter of B<getopt> that does not start with a 'B<->' (and is not an option argument) is used as the short options string.  Each short option character in I<shortopts> may be followed by one colon to indicate it has a required argument, and by two colons to indicate it has an optional argument.  The first character of shortopts may be 'B<+>' or 'B<->' to influence the way options are parsed and output is generated (see section B<SCANNING MODES> for details).
fr: Les options courtes (un seul caractère) à reconnaître. Si cette option n'est pas trouvée, le premier paramètre de B<getopt> qui ne commence pas par un « B<-> » (et qui n'est pas un paramètre d'une option) est utilisé comme chaîne de description des options courtes. Chaque caractère d'option courte de I<options_courtes> peut être suivi d'un signe deux-points pour indiquer que l'option attend un paramètre ou de deux signes deux-points pour indiquer qu'elle a un paramètre optionnel. Le premier caractère de I<options_courtes> peut être un « B<+> » ou un « B<-> » pour modifier la façon dont les options sont analysées et dont la sortie est produite (consultez la section B<MODES D'ANALYSE> pour plus de précisions).

note: type: Plain text
en: Disable error reporting by getopt(3).
fr: Désactiver le signalement des erreurs par B<getopt>(3).

note: type: Plain text
en: Do not generate normal output.  Errors are still reported by B<getopt>(3), unless you also use B<-q>.
fr: Ne pas produire la sortie normale. Les erreurs sont toujours remontées par B<getopt>(3), sauf si l'option B<-q> est utilisée.

note: type: Plain text
en: Set quoting conventions to those of I<shell>.  If the B<-s> option is not given, the E<.SM BASH> conventions are used.  Valid arguments are currently 'B<sh>' 'B<bash>', 'B<csh>', and 'B<tcsh>'.
fr: Définir les règles de protection (avec des guillemets) à celles des interpréteurs de commandes I<shell>. En absence d’indication de l’option B<-s>, les conventions de E<.SM BASH> sont utilisées. Les valeurs acceptées sont « B<sh> », « B<bash> », « B<csh> » et « B<tcsh> ».

note: type: Plain text
en: Test if your B<getopt>(1)  is this enhanced version or an old version.  This generates no output, and sets the error status to 4.  Other implementations of B<getopt>(1), and this version if the environment variable B<GETOPT_COMPATIBLE> is set, will return 'B<-->' and error status 0.
fr: Vérifier si la version de B<getopt>(1) correspond à cette version améliorée ou à une version plus ancienne. Aucune sortie n'est créée et la valeur de retour est 4. Les autres implémentations de B<getopt>(1) (ou celle-ci si la variable d'environnement B<GETOPT_COMPATIBLE> est positionnée) renverront « B<--> », avec une valeur de retour de 0.

note: type: Plain text
en: Do not quote the output.  Note that whitespace and special (shell-dependent) characters can cause havoc in this mode (like they do with other B<getopt>(1)  implementations).
fr: Ne pas placer la sortie entre guillemets. Remarquez que les espaces et caractères spéciaux (pour l'interpréteur de commandes utilisé) peuvent poser des problèmes dans ce mode (comme pour les autres implémentations de B<getopt>(1)).

note: type: Plain text
en: Display version information and exit.  No other output is generated.
fr: Afficher le numéro de version puis quitter. Aucune autre sortie n'est créée.

note: type: SH
en: PARSING
fr: ANALYSE

note: type: Plain text
en: This section specifies the format of the second part of the parameters of B<getopt> (the I<parameters> in the B<SYNOPSIS>).  The next section (B<OUTPUT>)  describes the output that is generated.  These parameters were typically the parameters a shell function was called with.  Care must be taken that each parameter the shell function was called with corresponds to exactly one parameter in the parameter list of B<getopt> (see the B<EXAMPLES>).  All parsing is done by the GNU B<getopt>(3)  routines.
fr: Cette section indique le format de la seconde partie des paramètres de B<getopt> (I<paramètres> dans le B<SYNOPSIS>). La section suivante (B<SORTIE>) décrit la sortie renvoyée. Ces paramètres sont généralement ceux fournis à une fonction shell. Il faut faire attention à ce que chaque paramètre fourni à la fonction corresponde bien à un paramètre de la liste des paramètres de B<getopt> (consultez B<EXEMPLES>). Toutes les analyses sont faites en utilisant les routines B<getopt>(3).

note: type: Plain text
en: The parameters are parsed from left to right.  Each parameter is classified as a short option, a long option, an argument to an option, or a non-option parameter.
fr: Les paramètres sont analysés de la gauche vers la droite. Chaque paramètre est classé en option courte, option longue, argument d'une option ou paramètre n'étant pas une option.

note: type: Plain text
en: It is possible to specify several short options after one 'B<->', as long as all (except possibly the last) do not have required or optional arguments.
fr: Il est possible d'indiquer plusieurs options courtes après un « B<-> », tant que toutes les options (sauf peut-être la dernière) n'ont pas de paramètre obligatoire ou optionnel.

note: type: Plain text
en: Each parameter not starting with a 'B<->', and not a required argument of a previous option, is a non-option parameter.  Each parameter after a 'B<-->' parameter is always interpreted as a non-option parameter.  If the environment variable B<POSIXLY_CORRECT> is set, or if the short option string started with a 'B<+>', all remaining parameters are interpreted as non-option parameters as soon as the first non-option parameter is found.
fr: Chaque paramètre ne commençant pas par un « B<-> » et n'étant pas un paramètre obligatoire est un « paramètre n'étant pas une option ». Chaque paramètre situé après un « B<--> » est toujours interprété comme un « paramètre n'étant pas une option ». Si la variable d'environnement B<POSIXLY_CORRECT> est positionnée, ou si la chaîne des options courtes commence par un « B<+> », tous les paramètres suivant le premier paramètre n'étant pas une option sont interprétés comme des paramètres n'étant pas des options.

note: type: SH
en: OUTPUT
fr: SORTIE

note: type: Plain text
en: Output is generated for each element described in the previous section.  Output is done in the same order as the elements are specified in the input, except for non-option parameters.  Output can be done in I<compatible> (I<unquoted>)  mode, or in such way that whitespace and other special characters within arguments and non-option parameters are preserved (see B<QUOTING>).  When the output is processed in the shell script, it will seem to be composed of distinct elements that can be processed one by one (by using the shift command in most shell languages).  This is imperfect in unquoted mode, as elements can be split at unexpected places if they contain whitespace or special characters.
fr: La sortie est générée pour chaque élément décrit dans la section précédente. Elle reprend l'ordre des éléments indiqués en entrée, à l'exception des paramètres n'étant pas des options. La sortie peut être faite dans un mode I<compatible> (I<non protégé> : sans guillemet) ou de telle sorte que les espaces ou autres caractères spéciaux des paramètres soient préservés (consultez B<PROTECTION>). Quand la sortie est utilisée dans un script shell, elle paraîtra composée d'éléments distincts qui peuvent être traités un par un (en utilisant la commande shift de la plupart des langages de script). Ce n'est pas parfait dans le mode I<non protégé> parce que les éléments peuvent être coupés à des endroits non prévus s'ils contiennent des espaces ou caractères spéciaux.

note: type: Plain text
en: If there are problems parsing the parameters, for example because a required argument is not found or an option is not recognized, an error will be reported on stderr, there will be no output for the offending element, and a non-zero error status is returned.
fr: En cas de problème lors de l'analyse des paramètres, par exemple si un paramètre obligatoire n'est pas trouvé ou si une option n'est pas reconnue, une erreur est renvoyée sur la sortie d'erreur standard. Les éléments incriminés ne seront pas affichés et un code d'erreur non nul est renvoyé.

note: type: Plain text
en: For a short option, a single 'B<->' and the option character are generated as one parameter.  If the option has an argument, the next parameter will be the argument.  If the option takes an optional argument, but none was found, the next parameter will be generated but be empty in quoting mode, but no second parameter will be generated in unquoted (compatible) mode.  Note that many other B<getopt>(1)  implementations do not support optional arguments.
fr: Pour une option courte, un seul « B<-> » et le caractère de l'option sont générés comme un paramètre. Si l'option est suivie de son paramètre, le paramètre suivant de la sortie sera le paramètre de l'option. Si l'option accepte un paramètre optionnel, mais qu'aucun n'a été trouvé, un paramètre vide sera généré dans le mode protégé, mais aucun dans le mode non protégé (ou mode compatible). Notez que beaucoup d'autres implémentations de B<getopt>(1) ne gèrent pas les paramètres optionnels.

note: type: Plain text
en: If several short options were specified after a single 'B<->', each will be present in the output as a separate parameter.
fr: Si plusieurs options courtes ont été précisées après un unique « B<-> », chacune sera présente dans la sortie dans un paramètre distinct.

note: type: Plain text
en: For a long option, 'B<-->' and the full option name are generated as one parameter.  This is done regardless whether the option was abbreviated or specified with a single 'B<->' in the input.  Arguments are handled as with short options.
fr: Pour une option longue, « B<--> » et le nom complet de l'option sont générés en un seul paramètre. C'est le cas que l'option soit abrégée ou qu'elle soit indiquée avec un seul « B<-> » dans l'entrée. Les paramètres sont traités comme pour les options courtes.

note: type: Plain text
en: Normally, no non-option parameters output is generated until all options and their arguments have been generated.  Then 'B<-->' is generated as a single parameter, and after it the non-option parameters in the order they were found, each as a separate parameter.  Only if the first character of the short options string was a 'B<->', non-option parameter output is generated at the place they are found in the input (this is not supported if the first format of the B<SYNOPSIS> is used; in that case all preceding occurrences of 'B<->' and 'B<+>' are ignored).
fr: Normalement, aucun paramètre n'étant pas une option n'est généré sur la sortie tant que toutes les options et leurs paramètres n'ont pas été traités. Ensuite, « B<--> » est généré séparément comme un paramètre, et est suivi des paramètres n'étant pas des options, dans l'ordre où ils ont été trouvés, chacun comme un paramètre distinct. Si le premier caractère de la chaîne des options courtes est un « B<-> », et seulement dans ce cas, les paramètres n'étant pas des options sont générés quand ils sont trouvés dans l'entrée (ce n'est pas géré si la première forme du B<SYNOPSIS> est utilisée ; dans ce cas, les « B<-> » et « B<+> » de tête sont ignorés).

note: type: SH
en: QUOTING
fr: PROTECTION

note: type: Plain text
en: In compatible mode, whitespace or 'special' characters in arguments or non-option parameters are not handled correctly.  As the output is fed to the shell script, the script does not know how it is supposed to break the output into separate parameters.  To circumvent this problem, this implementation offers quoting.  The idea is that output is generated with quotes around each parameter.  When this output is once again fed to the shell (usually by a shell B<eval> command), it is split correctly into separate parameters.
fr: Dans le mode compatible, les espaces et caractères spéciaux dans les paramètres des options ou les paramètres n'étant pas des options ne sont pas gérés correctement. Comme la sortie est envoyée à un script shell, le script ne sait pas comment il doit séparer les paramètres. Pour éviter ce problème, cette implémentation propose un mode protégé. L'idée est de générer la sortie avec des protections (à l'aide de guillemets) autour des paramètres. Quand cette sortie est envoyée de nouveau à un interpréteur de commandes (généralement en utilisant la commande B<eval> de l'interpréteur), le découpage en paramètres est correct.

note: type: Plain text
en: Quoting is not enabled if the environment variable B<GETOPT_COMPATIBLE> is set, if the first form of the B<SYNOPSIS> is used, or if the option 'B<-u>' is found.
fr: La protection n'est pas activée si la variable d'environnement B<GETOPT_COMPATIBLE> est positionnée, si la première forme du B<SYNOPSIS> est utilisée ou si l'option « B<-u> » est trouvée.

note: type: Plain text
en: Different shells use different quoting conventions.  You can use the 'B<-s>' option to select the shell you are using.  The following shells are currently supported: 'B<sh>', 'B<bash>', 'B<csh>' and 'B<tcsh>'.  Actually, only two 'flavors' are distinguished: sh-like quoting conventions and csh-like quoting conventions.  Chances are that if you use another shell script language, one of these flavors can still be used.
fr: Les conventions de protections diffèrent suivant les interpréteurs de commandes. Vous pouvez préciser l'interpréteur de commandes que vous utilisez avec l'option « B<-s> ». Les interpréteurs de commandes suivants sont gérés : « B<sh> », « B<bash> », « B<csh> » et « B<tcsh> ». En fait, seuls deux types sont différenciés : ceux utilisant les conventions de sh et ceux utilisant les conventions de csh. Il y a de grandes chances que si vous utilisez un autre langage de script, il utilise une de ces conventions.

note: type: SH
en: SCANNING MODES
fr: MODES D'ANALYSE

note: type: Plain text
en: The first character of the short options string may be a 'B<->' or a 'B<+>' to indicate a special scanning mode.  If the first calling form in the B<SYNOPSIS> is used they are ignored; the environment variable B<POSIXLY_CORRECT> is still examined, though.
fr: Le premier caractère de la chaîne de description des options courtes peut être un « B<-> » ou un « B<+> » pour utiliser un mode spécial d'analyse. Si la première forme du B<SYNOPSIS> est appelée, ils sont ignorés ; mais la variable d'environnement B<POSIXLY_CORRECT> est toujours examinée.

note: type: Plain text
en: If the first character is a 'B<->', non-option parameters are outputted at the place where they are found; in normal operation, they are all collected at the end of output after a 'B<-->' parameter has been generated.  Note that this 'B<-->' parameter is still generated, but it will always be the last parameter in this mode.
fr: Si le premier caractère est un « B<-> », les paramètres qui ne sont pas des options sont placés dans la sortie à la position où ils ont été trouvés ; normalement, ils sont tous placés à la fin de la sortie, juste après le paramètre « B<--> » qui a été généré. Notez que dans ce mode, le paramètre « B<--> » est encore généré, mais il sera toujours le dernier paramètre.

note: type: SH
en: COMPATIBILITY
fr: COMPATIBILITÉ

note: type: Plain text
en: This version of B<getopt>(1)  is written to be as compatible as possible to other versions.  Usually you can just replace them with this version without any modifications, and with some advantages.
fr: Cette version de B<getopt>(1) a été écrite pour être aussi compatible que possible avec les autres versions. En général, vous pouvez vous contenter de les remplacer par cette version sans aucune modification, avec même certains avantages.

note: type: Plain text
en: The environment variable B<GETOPT_COMPATIBLE> forces B<getopt> into compatibility mode.  Setting both this environment variable and B<POSIXLY_CORRECT> offers 100% compatibility for 'difficult' programs.  Usually, though, neither is needed.
fr: La variable d'environnement B<GETOPT_COMPATIBLE> force B<getopt> dans un mode de compatibilité. Avec à la fois cette variable d'environnement et B<POSIXLY_CORRECT>, il sera 100 % compatible pour les programmes « difficiles ». D'habitude, cependant, aucune n'est nécessaire.

note: type: Plain text
en: In compatibility mode, leading 'B<->' and 'B<+>' characters in the short options string are ignored.
fr: Dans ce mode, les « B<-> » ou « B<+> » de tête des options courtes sont ignorés.

note: type: SH
en: RETURN CODES
fr: CODES DE RETOUR

note: type: Plain text
en: B<getopt> returns error code B<0> for successful parsing, B<1> if B<getopt>(3)  returns errors, B<2> if it does not understand its own parameters, B<3> if an internal error occurs like out-of-memory, and B<4> if it is called with B<-T>.
fr: Le code de retour de B<getopt> est B<0> en cas de réussite lors de l'analyse des options, B<1> si B<getopt>(3) signale des erreurs, B<2> s'il ne comprend pas ses propres paramètres, B<3> dans le cas d'une erreur interne (comme un manque de mémoire) et B<4> lorsque l'option B<-T> est utilisée.

note: type: SH
en: EXAMPLES
fr: EXEMPLES

note: type: SH
en: ENVIRONMENT
fr: ENVIRONNEMENT

note: type: Plain text
en: This environment variable is examined by the B<getopt>(3)  routines.  If it is set, parsing stops as soon as a parameter is found that is not an option or an option argument.  All remaining parameters are also interpreted as non-option parameters, regardless whether they start with a 'B<->'.
fr: Cette variable d'environnement est utilisée par B<getopt>(3). Lorsqu'elle est positionnée, l'analyse s'arrête au premier paramètre n'étant ni une option ni le paramètre d'une option. Tous les paramètres restants sont également interprétés comme des paramètres n'étant pas des options, qu'ils commencent par un « B<-> » ou non.

note: type: IP
en: GETOPT_COMPATIBLE
fr: B<GETOPT_COMPATIBLE>

note: type: Plain text
en: Forces B<getopt> to use the first calling format as specified in the B<SYNOPSIS>.
fr: Force B<getopt> à utiliser le premier format d'appel, comme indiqué dans le B<SYNOPSIS>.

note: type: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: The syntax if you do not want any short option variables at all is not very intuitive (you have to set them explicitly to the empty string).
fr: La syntaxe n'est pas très intuitive si vous ne voulez pas d'option courte : vous devez explicitement les définir comme des chaînes vides.

note: type: SH
en: AUTHOR
fr: AUTEUR

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

note: type: SH
en: AVAILABILITY
fr: DISPONIBILITÉ
