/
ixpc.1
92 lines (91 loc) · 2 KB
/
ixpc.1
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
.TH IXPC 1 ixpc-VERSION
.SH NAME
ixpc \- ixp client
.SH SYNOPSIS
.B ixpc
.RB [ \-a
.IR address ]
.I action
.I file
.br
.B ixpc
.B \-v
.SH DESCRIPTION
.SS Overview
.B ixpc
is a client to access a 9P file server from the command line or from shell
scripts. It can be used to configure
.BR wmii (1).
.SS Options
.TP
.BI \-a " address"
Lets you specify the address to which
.B ixpc
will establish a connection. If this option is not supplied, and the
environment variable IXP_ADDRESS is set,
.B ixpc
will use this value as its address. Currently, the address can only be a
unix socket file or a tcp socket. The syntax for
.I address
is taken (along with many other profound ideas) from the Plan 9 operating
system and has the form
.BR unix!/path/to/socket
for unix socket files, and
.BR tcp!hostname!port
for tcp sockets.
.TP
.B \-v
Prints version information to stdout, then exits.
.TP
The syntax of the actions is as follows:
.TP
.B write
Writes the supplied data from the standard input to
.IR file,
overwriting any previous data. The data to be written is arbitrary
and only gains meaning (and restrictions) when it is interpreted by
.BR wmiiwm (1).
See
.B EXAMPLES
below.
.TP
.B xwrite
The same as write, but the data is taken from subsequent arguments,
rather than the standard input.
.TP
.B create
Creates file or directory. If the file exists,
nothing is done.
.TP
.B ls
Lists files and directories.
.TP
.B read
Reads file or directory contents.
.TP
.B remove
Removes file or directory tree.
.SH ENVIRONMENT
.TP
IXP_ADDRESS
See above.
.SH EXAMPLES
.TP
.B ixpc ls /
This prints the root directory of the wmii filesystem, if IXP_ADDRESS is set
to the address of wmii. For more information about the contents of this
filesystem, see
.BR wmiiwm (1).
.TP
.B ixpc xwrite /ctl quit
Write 'quit' to the main control file of the wmii filesystem, effectively
leaving wmii.
.TP
.B ixpc write /keys \< keys.txt
Replace the contents of
.I /keys
with the contents of
.I keys.txt
.SH SEE ALSO
.BR wmii (1)
http://www.cs.bell-labs.com/sys/man/5/INDEX.html