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: src/sbin/atm/ilmid/ilmid.8,v 1.3.2.2 2002/08/21 18:58:05 trhodes Exp $
  26 .\"
  27 .\"
  28 .Dd September 14, 1998
  29 .Dt ILMID 8
  30 .Os
  31 .Sh NAME
  32 .Nm ilmid
  33 .Nd "simple ILMI ATM address registration daemon"
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl d Ar level
  37 .Op Fl f
  38 .Op Fl r
  39 .Sh DESCRIPTION
  40 The
  41 .Nm
  42 utility is a HARP ATM daemon that performs the ILMI ATM address registration
  43 procedures with an ATM network switch.
  44 It is normally invoked at boot time
  45 from the ATM startup script.
  46 .Pp
  47 For each ATM interface with a UNI signalling manager attached,
  48 .Nm
  49 will open an ILMI PVC (VPI = 0, VCI = 16) and register the interface's
  50 ATM address with the switch.
  51 As part of the address registration procedure,
  52 the ATM switch will notify the endsystem (local host) of the
  53 .Dq "network prefix"
  54 portion of the endsystem's ATM address and
  55 .Nm
  56 will notify the switch of the endsystem's
  57 .Dq "user part"
  58 of its address
  59 (typically the interface card MAC address).
  60 .Sh OPTIONS
  61 .Bl -tag -width indent
  62 .It Fl d Ar level
  63 Specify the debug level for optional protocol tracing.
  64 Messages are
  65 written to
  66 .Pa /var/log/ilmid .
  67 .It Fl f
  68 Causes
  69 .Nm
  70 to run in the foreground.
  71 .It Fl r
  72 Causes
  73 .Nm
  74 to issue a coldStart TRAP on all ATM interfaces it's able to open and exit.
  75 .El
  76 .Sh NOTES
  77 This daemon does not fully conform to the ATM Forum ILMI specifications.
  78 In particular, it
  79 does not make any queries of the network side to ensure
  80 that the ATM Address table is empty.
  81 It also does not implement any
  82 of the ATM Forum MIB that is specified as part of ILMI.
  83 .Pp
  84 The
  85 .Nm
  86 utility will increment the debug level when it receives a
  87 .Dv SIGUSR1
  88 signal and will
  89 decrement the debug level when it receives a
  90 .Dv SIGUSR2
  91 signal.
  92 .Sh SEE ALSO
  93 The ATM Forum,
  94 .%T "ATM User-Network Interface, Version 3.1 (UNI 3.1) Specification"
  95 for details on the ILMI protocols and address registration
  96 procedures.
  97 .Sh COPYRIGHT
  98 Copyright (c) 1994-1998, Network Computing Services, Inc.
  99 .Sh AUTHORS
 100 .An John Cavanaugh ,
 101 Network Computing Services, Inc.
 102 .An Mike Spengler ,
 103 Network Computing Services, Inc.
 104 .An Joseph Thomas ,
 105 Network Computing Services, Inc.
 106 .Sh ACKNOWLEDGMENTS
 107 This software was developed with the support of the
 108 Defense Advanced Research Projects Agency (DARPA).
 109 .Sh BUGS
 110 Please report any bugs to
 111 .Aq Mt harp-bugs@magic.net .