sys/man/8/trampoline

   1 .TH TRAMPOLINE 8
   2 .SH NAME
   3 trampoline \- forward incoming calls to another address
   4 .SH SYNOPSIS
   5 .B aux/trampoline
   6 [
   7 .B -9
   8 ]
   9 [
  10 .B -a
  11 .I altaddr
  12 ]
  13 [
  14 .B -m
  15 .I netdir
  16 ]
  17 .I addr
  18 .SH DESCRIPTION
  19 .I Trampoline
  20 can be used in a service file (see
  21 .IR listen (8))
  22 to link an incoming call to
  23 another address that provides the service, typically on another machine.
  24 .PP
  25 .I Trampoline
  26 dials
  27 .I addr
  28 and copies data between that connection
  29 and its own standard input and output.
  30 .PP
  31 The options are:
  32 .TP
  33 .B -9
  34 The connection carries only 9P messages.  In this case
  35 .I trampoline
  36 will relay whole messages at a time.
  37 .TP
  38 .BI -a " altaddr
  39 Dial
  40 .I altaddr
  41 and relay between the two network connections,
  42 ignoring standard input and output.
  43 .TP
  44 .BI -m " netdir
  45 Restrict forwarding to particular machines.
  46 .I Netdir
  47 must be the incoming call directory.
  48 .I Trampoline
  49 finds the caller's MAC address
  50 .I m
  51 and checks that
  52 .IR ndb (6)
  53 contains an entry with
  54 .BI ether= m
  55 and the attribute
  56 .BR trampok .
  57 If no such entry is found, the call is rejected.
  58 .PD
  59 .SH FILES
  60 .TF /sys/log/trampoline
  61 .TP
  62 .B /sys/log/trampoline
  63 logs rejected calls
  64 .SH SOURCE
  65 .B /sys/src/cmd/aux/trampoline.c
  66 .SH SEE ALSO
  67 .IR dial (2),
  68 .IR listen (8)