summaryrefslogtreecommitdiffstats
path: root/docs/help/exec
blob: bb6f4f1a1a1817934f778102138010203bbea721 (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
%9Syntax:%9

EXEC %|[-] [-nosh] [-out | -msg <target> | -notice <target>] [-name <name>] <cmd line>
EXEC %|-out | -window | -msg <target> | -notice <target> | -close | -<signal> %<id>
EXEC %|-in %<id> <text to send to process>

%9Parameters:%9

    -:               Suppresses the process termination notification.
    -nosh:           Doesn't execute the command through /bin/sh.
    -out:            Sends the output to the active channel or query.
    -msg:            Sends the output to the specified nickname or channel.
    -notice:         Sends the output to the specified nickname or channel as
                     notices.
    -name:           Gives the process the specified name.
    -window:         Displays the output in the active window.
    -close:          Forcibly closes a process that doesn't die.
    -<signal>:       Sends the given signal to the process.
    -in:             Sends text to the standard input of the process.
    -interactive:    Executes the process in a new window item.

    The command to execute; if no output parameter is given, the active window
    will be used and if no parameters are given at all, the list of active
    processes will be displayed.

%9Description:%9

    Executes the specified command in the background; the process can be
    accessed by its id or the name you gave it.

    The output of the process can be redirected to various targets, such as
    a window, a channel, a nickname or a query.

    The process identifier must always begin with the '%%' character. For
    example %%0.

    If you remove a process with the close parameter, it will only make Irssi
    detach from it; the process will keep running until it terminates.

%9Examples:%9

    /EXEC
    /EXEC ls
    /EXEC -msg #irssi cat unicorn.txt
    /EXEC -out cat /etc/passwd | grep $USER | awk -F: '{print $5}'
    /EXEC -name ssh -nosh -interactive -window ssh staff.irssi.org
    /EXEC -close mailserver
    /EXEC -close %%0

%9See also:%9 CAT, CD, ECHO, EVAL