1 1821f772 2005-03-18 devnull .TH NETFILES 1
  2 26d43ca6 2005-03-18 devnull .SH NAME
  3 26d43ca6 2005-03-18 devnull Netfiles, netfileget, netfileput, netfilestat \- network file access inside acme
  4 26d43ca6 2005-03-18 devnull .SH SYNOPSIS
  5 26d43ca6 2005-03-18 devnull .B Netfiles
  6 26d43ca6 2005-03-18 devnull .PP
  7 26d43ca6 2005-03-18 devnull .B netfileget
  8 26d43ca6 2005-03-18 devnull [
  9 26d43ca6 2005-03-18 devnull .B -d
 10 26d43ca6 2005-03-18 devnull ]
 11 26d43ca6 2005-03-18 devnull .I system
 12 26d43ca6 2005-03-18 devnull .I path
 13 26d43ca6 2005-03-18 devnull .PP
 14 26d43ca6 2005-03-18 devnull .B netfileput
 15 26d43ca6 2005-03-18 devnull .I system
 16 26d43ca6 2005-03-18 devnull .I path
 17 26d43ca6 2005-03-18 devnull .PP
 18 26d43ca6 2005-03-18 devnull .B netfilestat
 19 26d43ca6 2005-03-18 devnull .I system
 20 26d43ca6 2005-03-18 devnull .I path
 21 26d43ca6 2005-03-18 devnull .SH DESCRIPTION
 22 26d43ca6 2005-03-18 devnull .B Netfiles
 23 26d43ca6 2005-03-18 devnull presents remote file systems in
 24 d32deab1 2020-08-16 rsc .MR acme (4)
 25 26d43ca6 2005-03-18 devnull windows.
 26 26d43ca6 2005-03-18 devnull Each window is named
 27 26d43ca6 2005-03-18 devnull .BI /n/ system / path
 28 26d43ca6 2005-03-18 devnull and displays the contents of
 29 26d43ca6 2005-03-18 devnull .I path
 30 26d43ca6 2005-03-18 devnull on 
 31 26d43ca6 2005-03-18 devnull .IR system .
 32 26d43ca6 2005-03-18 devnull .PP
 33 26d43ca6 2005-03-18 devnull .I Netfiles
 34 26d43ca6 2005-03-18 devnull reads names of windows to create from the
 35 26d43ca6 2005-03-18 devnull plumbing channel
 36 26d43ca6 2005-03-18 devnull .B netfileedit
 37 26d43ca6 2005-03-18 devnull (see
 38 d32deab1 2020-08-16 rsc .MR plumber (4)
 39 26d43ca6 2005-03-18 devnull and the example section below).
 40 26d43ca6 2005-03-18 devnull In a
 41 26d43ca6 2005-03-18 devnull .IR netfiles -controlled
 42 26d43ca6 2005-03-18 devnull window,
 43 26d43ca6 2005-03-18 devnull .BR Get ,
 44 26d43ca6 2005-03-18 devnull .BR Put ,
 45 26d43ca6 2005-03-18 devnull and
 46 26d43ca6 2005-03-18 devnull button 3 loads work as in normal acme windows.
 47 26d43ca6 2005-03-18 devnull External commands executed with button 2
 48 26d43ca6 2005-03-18 devnull run in the directory in which
 49 26d43ca6 2005-03-18 devnull .I acme
 50 26d43ca6 2005-03-18 devnull was started.
 51 26d43ca6 2005-03-18 devnull .PP
 52 26d43ca6 2005-03-18 devnull .I Netfiles
 53 26d43ca6 2005-03-18 devnull uses the helper programs
 54 26d43ca6 2005-03-18 devnull .IR netfileget ,
 55 26d43ca6 2005-03-18 devnull .IR netfileput ,
 56 26d43ca6 2005-03-18 devnull and
 57 26d43ca6 2005-03-18 devnull .I netfilestat
 58 26d43ca6 2005-03-18 devnull to access the remote file systems.
 59 26d43ca6 2005-03-18 devnull The three first check to see if 
 60 26d43ca6 2005-03-18 devnull .I system
 61 26d43ca6 2005-03-18 devnull is a service in the current name space
 62 26d43ca6 2005-03-18 devnull (see
 63 d32deab1 2020-08-16 rsc .MR intro (4) ).
 64 26d43ca6 2005-03-18 devnull If so, they use
 65 d32deab1 2020-08-16 rsc .MR 9p (1)
 66 26d43ca6 2005-03-18 devnull to access it.
 67 26d43ca6 2005-03-18 devnull Otherwise, they assume that the system is a network name
 68 26d43ca6 2005-03-18 devnull and use
 69 d32deab1 2020-08-16 rsc .MR ssh (1) 's
 70 26d43ca6 2005-03-18 devnull .I sftp
 71 26d43ca6 2005-03-18 devnull to access it.
 72 26d43ca6 2005-03-18 devnull .PP
 73 26d43ca6 2005-03-18 devnull .I Netfileget
 74 26d43ca6 2005-03-18 devnull prints the contents of the named
 75 26d43ca6 2005-03-18 devnull .I path 
 76 26d43ca6 2005-03-18 devnull to standard output.
 77 26d43ca6 2005-03-18 devnull If the
 78 26d43ca6 2005-03-18 devnull .B -d
 79 26d43ca6 2005-03-18 devnull option is given, then
 80 26d43ca6 2005-03-18 devnull .I netfileget
 81 26d43ca6 2005-03-18 devnull prints a single-column listing of
 82 26d43ca6 2005-03-18 devnull .IR path ,
 83 26d43ca6 2005-03-18 devnull which must be a directory.
 84 26d43ca6 2005-03-18 devnull Directories in the listing have
 85 26d43ca6 2005-03-18 devnull .L /
 86 26d43ca6 2005-03-18 devnull appended to their names.
 87 26d43ca6 2005-03-18 devnull .PP
 88 26d43ca6 2005-03-18 devnull .I Netfileput
 89 26d43ca6 2005-03-18 devnull writes its standard input to the named
 90 26d43ca6 2005-03-18 devnull .IR path .
 91 26d43ca6 2005-03-18 devnull .PP
 92 26d43ca6 2005-03-18 devnull .I Netfilestat
 93 26d43ca6 2005-03-18 devnull prints the file type of
 94 26d43ca6 2005-03-18 devnull .IR path ,
 95 26d43ca6 2005-03-18 devnull one of
 96 26d43ca6 2005-03-18 devnull .BR nonexistent ,
 97 26d43ca6 2005-03-18 devnull .BR directory ,
 98 26d43ca6 2005-03-18 devnull or
 99 26d43ca6 2005-03-18 devnull .BR file .
100 26d43ca6 2005-03-18 devnull .SH EXAMPLES
101 26d43ca6 2005-03-18 devnull The following plumbing rule 
102 26d43ca6 2005-03-18 devnull (see
103 d32deab1 2020-08-16 rsc .MR plumb (7) )
104 26d43ca6 2005-03-18 devnull passes 
105 26d43ca6 2005-03-18 devnull .B /n/
106 26d43ca6 2005-03-18 devnull paths to 
107 26d43ca6 2005-03-18 devnull .IR Netfiles ,
108 26d43ca6 2005-03-18 devnull starting it if necessary.
109 26d43ca6 2005-03-18 devnull .IP
110 26d43ca6 2005-03-18 devnull .EX
111 26d43ca6 2005-03-18 devnull # /n/ paths go to simulator in acme
112 26d43ca6 2005-03-18 devnull kind is text
113 26d43ca6 2005-03-18 devnull data matches '[a-zA-Z0-9_\e-./]+('$addr')?'
114 26d43ca6 2005-03-18 devnull data matches '(/n/[a-zA-Z0-9_\e-./]+)('$addr')?'
115 26d43ca6 2005-03-18 devnull plumb to netfileedit
116 26d43ca6 2005-03-18 devnull plumb client Netfiles
117 26d43ca6 2005-03-18 devnull .EE
118 26d43ca6 2005-03-18 devnull .SH SOURCE
119 26d43ca6 2005-03-18 devnull .B \*9/src/cmd/netfiles
120 26d43ca6 2005-03-18 devnull .SH SEE ALSO
121 d32deab1 2020-08-16 rsc .MR 9p (1) ,
122 d32deab1 2020-08-16 rsc .MR ssh (1) ,
123 d32deab1 2020-08-16 rsc .MR ssh-agent (1) ,
124 d32deab1 2020-08-16 rsc .MR intro (4) ,
125 d32deab1 2020-08-16 rsc .MR acme (4) ,
126 d32deab1 2020-08-16 rsc .MR factotum (4) ,
127 26d43ca6 2005-03-18 devnull .HR http://v9fs.sf.net
128 9cac97f2 2009-05-17 rsc .SH BUGS
129 9cac97f2 2009-05-17 rsc .I Netfiles
130 9cac97f2 2009-05-17 rsc depends on
131 d32deab1 2020-08-16 rsc .MR sftpcache (1) ,
132 9cac97f2 2009-05-17 rsc which only works with OpenSSH versions 4.3 and earlier;
133 9cac97f2 2009-05-17 rsc later versions do not print the
134 9cac97f2 2009-05-17 rsc .B sftp>
135 9cac97f2 2009-05-17 rsc prompt frequently enough.