6/sbin/atm/ilmid/ilmid.8

   1 .\"
   2 .\" ===================================
   3 .\" HARP  |  Host ATM Research Platform
   4 .\" ===================================
   5 .\"
   6 .\"
   7 .\" This Host ATM Research Platform ("HARP") file (the "Software") is
   8 .\" made available by Network Computing Services, Inc. ("NetworkCS")
   9 .\" "AS IS".  NetworkCS does not provide maintenance, improvements or
  10 .\" support of any kind.
  11 .\"
  12 .\" NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
  13 .\" INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
  14 .\" AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
  15 .\" SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
  16 .\" In no event shall NetworkCS be responsible for any damages, including
  17 .\" but not limited to consequential damages, arising from or relating to
  18 .\" any use of the Software or related support.
  19 .\"
  20 .\" Copyright 1994-1998 Network Computing Services, Inc.
  21 .\"
  22 .\" Copies of this Software may be made, however, the above copyright
  23 .\" notice must be reproduced on all copies.
  24 .\"
  25 .\" $FreeBSD$
  26 .\"
  27 .Dd September 14, 1998
  28 .Dt ILMID 8
  29 .Os
  30 .Sh NAME
  31 .Nm ilmid
  32 .Nd "simple ILMI ATM address registration daemon"
  33 .Sh SYNOPSIS
  34 .Nm
  35 .Op Fl d Ar level
  36 .Op Fl f
  37 .Op Fl r
  38 .Sh DESCRIPTION
  39 The
  40 .Nm
  41 utility is a HARP ATM daemon that performs the ILMI ATM address registration
  42 procedures with an ATM network switch.
  43 It is normally invoked at boot time
  44 from the ATM startup script.
  45 .Pp
  46 For each ATM interface with a UNI signalling manager attached,
  47 .Nm
  48 will open an ILMI PVC (VPI = 0, VCI = 16) and register the interface's
  49 ATM address with the switch.
  50 As part of the address registration procedure,
  51 the ATM switch will notify the endsystem (local host) of the
  52 .Dq "network prefix"
  53 portion of the endsystem's ATM address and
  54 .Nm
  55 will notify the switch of the endsystem's
  56 .Dq "user part"
  57 of its address
  58 (typically the interface card MAC address).
  59 .Sh OPTIONS
  60 .Bl -tag -width indent
  61 .It Fl d Ar level
  62 Specify the debug level for optional protocol tracing.
  63 Messages are
  64 written to
  65 .Pa /var/log/ilmid .
  66 .It Fl f
  67 Causes
  68 .Nm
  69 to run in the foreground.
  70 .It Fl r
  71 Causes
  72 .Nm
  73 to issue a coldStart TRAP on all ATM interfaces it is able to open and exit.
  74 .El
  75 .Sh NOTES
  76 This daemon does not fully conform to the ATM Forum ILMI specifications.
  77 In particular, it
  78 does not make any queries of the network side to ensure
  79 that the ATM Address table is empty.
  80 It also does not implement any
  81 of the ATM Forum MIB that is specified as part of ILMI.
  82 .Pp
  83 The
  84 .Nm
  85 utility will increment the debug level when it receives a
  86 .Dv SIGUSR1
  87 signal and will
  88 decrement the debug level when it receives a
  89 .Dv SIGUSR2
  90 signal.
  91 .Sh SEE ALSO
  92 The ATM Forum,
  93 .%T "ATM User-Network Interface, Version 3.1 (UNI 3.1) Specification"
  94 for details on the ILMI protocols and address registration
  95 procedures.
  96 .Sh COPYRIGHT
  97 Copyright (c) 1994-1998, Network Computing Services, Inc.
  98 .Sh AUTHORS
  99 .An John Cavanaugh ,
 100 Network Computing Services, Inc.
 101 .An Mike Spengler ,
 102 Network Computing Services, Inc.
 103 .An Joseph Thomas ,
 104 Network Computing Services, Inc.
 105 .Sh ACKNOWLEDGMENTS
 106 This software was developed with the support of the
 107 Defense Advanced Research Projects Agency (DARPA).
 108 .Sh BUGS
 109 Please report any bugs to
 110 .Aq harp\-bugs@magic.net .