stub 943 B

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. .TH STUB 8
  2. .SH NAME
  3. stub \- provide mount point stubs
  4. .SH SYNOPSIS
  5. .B aux/stub
  6. [
  7. .B -Dd
  8. ]
  9. .I path/name
  10. .SH DESCRIPTION
  11. .I Aux/stub
  12. union mounts itself before
  13. .I path
  14. in the name space.
  15. It serves a file system containing a single entry,
  16. .IR name ,
  17. with file mode 0.
  18. The intent is to provide a place to bind or mount other resources.
  19. The options are:
  20. .TP
  21. .B -D
  22. print all 9P messages
  23. .TP
  24. .B -d
  25. make
  26. .I name
  27. a directory; by default it is a file
  28. .PD
  29. .SH EXAMPLE
  30. Use
  31. .I stub
  32. and
  33. .I sshnet
  34. (see
  35. .IR ssh (1))
  36. to create a new network protocol
  37. .RB `` mit ''
  38. that is actually TCP tunneled via SSH to a machine
  39. at MIT:
  40. .IP
  41. .EX
  42. % sshnet -m /net.alt amsterdam.lcs.mit.edu
  43. % aux/stub -d /net/mit
  44. % bind /net.alt/tcp /net/mit
  45. % con -l mit!plan9.bell-labs.com!whoami
  46. connected to mit!plan9.bell-labs.com!whoami on /net/mit/0
  47. i am 204.178.31.2 sysname achille you are 18.26.4.9 port 1248
  48. %
  49. .EE
  50. .SH SOURCE
  51. .B /sys/src/cmd/aux/stub.c
  52. .SH SEE ALSO
  53. .IR mntgen (4)