summaryrefslogtreecommitdiff
path: root/doc/fr/autogen/user/exec_commands.adoc
blob: 4404686432d520b32c7c94dc2ce0b58f11a02824 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
//
// This file is auto-generated by script docgen.py.
// DO NOT EDIT BY HAND!
//
[[command_exec_exec]]
* `+exec+`: exécuter des commandes externes

----
/exec  -list
       [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <nom>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] |-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <délai>] [-name <nom>] [-pipe <commande>] [-hsignal <nom>] <commande>
       -in <id> <texte>
       -inclose <id> [<texte>]
       -signal <id> <signal>
       -kill <id>
       -killall
       -set <id> <propriété> <valeur>
       -del <id>|-all [<id>...]

    -list : lister les commandes
      -sh : utiliser le shell pour exécuter la commande, plusieurs commandes peuvent être enchaînées avec des pipes (ATTENTION : utilisez cette option SEULEMENT si tous les paramètres sont fiables, voir l'option -nosh)
    -nosh : ne pas utiliser le shell pour exécuter la commande (requis si la commande a des données non fiables, par exemple le contenu d'un message d'un autre utilisateur) (par défaut)
      -bg : lancer le processus en tâche de fond : ne pas afficher la sortie ni le code retour (non compatible avec les options -o/-oc/-n/-nf/-pipe/-hsignal)
    -nobg : capturer la sortie du processus et afficher le code retour (par défaut)
   -stdin : créer un tuyau pour envoyer des données sur l'entrée standard du processus (avec /exec -in/-inclose)
 -nostdin : ne pas créer de tuyau pour l'entrée standard (par défaut)
  -buffer : afficher/envoyer la sortie de la commande sur ce tampon (si le tampon n'est pas trouvé, un nouveau tampon avec le nom "exec.exec.xxx" est créé)
       -l : afficher localement la sortie de la commande sur le tampon (par défaut)
       -o : envoyer la sortie de la commande au tampon sans exécuter les commandes (non compatible avec les options -bg/-pipe/-hsignal)
      -oc : envoyer la sortie de la commande au tampon et exécuter les commandes (lignes commençant par "/" ou un caractère personnalisé de commande) (non compatible avec les options -bg/-pipe/-hsignal)
       -n : afficher la sortie de la commande dans un nouveau tampon (non compatible avec les options -bg/-pipe/-hsignal)
      -nf : afficher la sortie de la commande dans un nouveau tampon avec contenu libre (pas de coupure des mots, pas de limite sur le nombre de lignes) (non compatible avec les options -bg/-pipe/-hsignal)
      -cl : effacer le nouveau tampon avant d'afficher la sortie
    -nocl : ajouter au nouveau tampon sans effacer (par défaut)
      -sw : basculer vers le tampon de sortie (par défaut)
    -nosw : ne pas basculer vers le tampon de sortie
      -ln : afficher les numéros de ligne (par défaut dans un nouveau tampon seulement)
    -noln : ne pas afficher les numéros de ligne
   -flush : afficher la sortie de la commande en temps réel (par défaut)
 -noflush : afficher la sortie de la commande une fois qu'elle est terminée
   -color : action sur les couleurs ANSI dans la sortie :
               ansi : garder les codes ANSI tels quels
               auto : convertir les couleurs ANSI en couleurs WeeChat/IRC (par défaut)
                irc : convertir les couleurs ANSI en couleurs IRC
            weechat : convertir les couleurs ANSI en couleurs WeeChat
              strip : supprimer les couleurs ANSI
      -rc : afficher le code retour (par défaut)
    -norc : ne pas afficher le code retour
 -timeout : définir un délai maximum pour la commande (en secondes)
    -name : définir un nom pour la commande (pour la nommer plus tard avec /exec)
    -pipe : envoyer la sortie vers une commande WeeChat/extension (ligne par ligne) ; s'il y a des espaces dans la commande/paramètres, entourez les de guillemets ; la variable $line est remplacée par la ligne (par défaut la ligne est ajoutée après la commande, séparée par un espace) (non compatible avec les options -bg/-o/-oc/-n/-nf)
 -hsignal : envoyer la sortie sous forme de hsignal (pour être utilisé par exemple dans un trigger) (non compatible avec les options -bg/-o/-oc/-n/-nf)
 commande : la commande à exécuter ; si elle commence par "url:", le shell est désactivé et le contenu de l'URL est téléchargé et envoyé comme sortie
       id : identifiant de commande : soit le numéro ou le nom (si défini avec "-name xxx")
      -in : envoyer le texte sur l'entrée standard du processus
 -inclose : identique à -in, mais l'entrée standard est fermée après (et le texte est facultatif : sans texte, l'entrée standard est juste fermée)
  -signal : envoyer un signal au processus ; le signal peut être un entier ou l'un de ces noms : hup, int, quit, kill, term, usr1, usr2
    -kill : alias de "-signal <id> kill"
 -killall : tuer tous les processus
     -set : définir une propriété du hook (voir la fonction hook_set dans l'API de référence extension)
propriété : propriété du hook
   valeur : nouvelle valeur pour la propriété du hook
     -del : supprimer la commande terminée
     -all : supprimer toutes les commandes terminées

Les options par défaut peuvent être définies dans l'option exec.command.default_options.

Exemples :
  /exec -n ls -l /tmp
  /exec -sh -n ps xu | grep weechat
  /exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx
  /exec -nf -noln links -dump https://weechat.org/files/doc/devel/weechat_user.en.html
  /exec -o uptime
  /exec -pipe "/print Durée de fonctionnement de la machine :" uptime
  /exec -n tail -f /var/log/messages
  /exec -kill 0
----