about summary refs log tree commit diff
path: root/Doc/Zsh/mod_zpty.yo
blob: 664e2fabd7b4690e7ce920327c9997f2e64afd06 (plain) (blame)
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
COMMENT(!MOD!zsh/zpty
A builtin for starting a command in a pseudo-terminal.
!MOD!)
The tt(zsh/zpty) module offers one builtin:

startitem()
findex(zpty)
xitem(tt(zpty) [ tt(-e) ] [ tt(-b) ] var(name) var(command) [ var(args ...) ])
xitem(tt(zpty) tt(-d) [ var(names) ... ])
xitem(tt(zpty) tt(-w) [ tt(-n) ] var(name) var(strings ...))
xitem(tt(zpty) tt(-r) var(name) [ var(param) [ var(pattern) ] ])
xitem(tt(zpty) tt(-t) var(name))
item(tt(zpty) [ tt(-L) ])(
In the first form, the var(command) is started with the var(args) as
arguments.  The command runs under a newly assigned pseudo-terminal; this
is useful for running commands non-interactively which expect an
interactive environment.  The var(name) given is used to refer to this
command in later calls to tt(pty).  With the tt(-e) option given, the
pseudo-terminal will be set up so that input characters are echoed and 
with the tt(-b) option given, input and output from and to the
pseudo-terminal will be blocking.

The second form with the tt(-d) option is used to delete commands
previously started by supplying a list of their var(name)s.  If no
var(names) are given, all commands are deleted.  Deleting a command causes
the HUP signal to be sent to the corresponding process.

The tt(-w) option can be used to send the command var(name) the given
var(strings) as input (separated by spaces).  If the tt(-n) option is
not given, a newline will be added at the end.

The tt(-r) option can be used to read the output of the command
var(name).  Without a var(param) argument, the string read will be
printed to standard output.  With a var(param) argument, the string
read will be put in the parameter named var(param).  If the
var(pattern) is also given, output will be read until the whole string 
read matches the var(pattern).

The tt(-t) option can be used to test whether the command var(name) is 
still running.  It returns a zero value if the command is running and
a non-zero value otherwise.

The last form without any arguments is used to list the commands
currently defined.  If the tt(-L) option is given, this is done in the
form of calls to the tt(zpty) builtin.
)
enditem()