timport.4 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       timport.4 (1864B)
       ---
            1 .TH IMPORT 4
            2 .SH NAME
            3 import \- import 9P resources from another system
            4 .SH SYNOPSIS
            5 .B import
            6 [
            7 .B -dfx
            8 ]
            9 [
           10 .B -n
           11 .I ns
           12 ]
           13 [
           14 .B -p
           15 .I prog
           16 ]
           17 [
           18 .B -s
           19 .I service
           20 ]
           21 .I system
           22 .SH DESCRIPTION
           23 .I Import
           24 presents the 9P service
           25 .I service
           26 (default
           27 .BR plumb )
           28 running on
           29 .I system
           30 as a service on the local system,
           31 in the current name space.
           32 .PP
           33 The
           34 .B -n
           35 option sets the remote name space directory
           36 where
           37 .I import
           38 should expect to find
           39 .IR service .
           40 If it is not specified,
           41 .I import
           42 uses name of the local system's name space directory.
           43 (Since name space directories are conventionally inside
           44 .BR /tmp ,
           45 the path have different meanings on the two systems.)
           46 .PP
           47 .I Import
           48 connects to
           49 .I system
           50 using
           51 .MR ssh (1) .
           52 It invokes
           53 .I import
           54 on the remote system to carry out the remote
           55 side of the protocol.
           56 The
           57 .B -p
           58 option specifies the path to
           59 .I import
           60 on the remote system, in case it is not in the system search path.
           61 .PP
           62 The
           63 .B -d
           64 option turns on debugging.
           65 The
           66 .B -f
           67 option keeps
           68 .I import
           69 from forking itself into the background, also useful for debugging.
           70 .PP
           71 The
           72 .B -x
           73 option reverses the roles of the two machines,
           74 exporting the service to, instead of importing it from,
           75 the remote system.
           76 .SH EXAMPLE
           77 Suppose you run
           78 .B sam
           79 .B -r
           80 to the CPU server
           81 .IR anna .
           82 .I Sam
           83 wants to talk to a plumber on the local terminal,
           84 but the file names will refer to files on
           85 .IR anna .
           86 .PP
           87 To fix this problem, create a new name space directory
           88 and start a new plumber on
           89 .IR anna :
           90 .IP
           91 .EX
           92 remotens=/tmp/ns.`whoami`.on.`hostname`
           93 ssh anna mkdir $remotens
           94 ssh anna NAMESPACE=$remotens plumber
           95 .EE
           96 .LP
           97 Now import that plumber to the local name space before starting
           98 .I sam
           99 and
          100 .IR 9term :
          101 .IP
          102 .EX
          103 NAMESPACE=/tmp/ns.anna
          104 mkdir $NAMESPACE
          105 import -n $remotens -s plumb anna
          106 sam &
          107 9term ssh anna &
          108 .EE
          109 .SH SOURCE
          110 .B \*9/src/cmd/import.c
          111 .SH SEE ALSO
          112 .MR 9pserve (4) ,
          113 .MR intro (4)