Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ lcnet — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

LCNODE

9.5;lcnet (list_connected_networks), revision 9.5, 87/01/20
LCNET (LIST_CONNECTED_NETWORKS) -- Display internet routing information.
usage:  LCNET [-FULL] [-CONN] [-LOCAL] [-N node_spec] [-HW] [-C]


FORMAT

  LCNET [options]


  LCNET  displays  the  list of known networks, their distances from the current
  node, the router used as  the  first  hop  towards  that  network,  and  other
  information.

  The  distances  (hops)  towards  remote  networks  are measured in intervening
  routers. The distances are all for one-way traffic; if a network is three hops
  away  from  yours,  your  requests  pass  through three routers to get to that
  network. The responses also pass through three routers on the way back.

  The -CONN option shows you the  full  internet  topology,  i.e.  the  list  of
  networks and how the routers connect them together.


OPTIONS

  Default options are indicated by "(D)."

  -LOCAL       (D)    Display  the  'First  Hop' and 'Hops' information for each
                     network in the internet.  The first hop is the node ID of a
                     router  on  your  network.  It  is the first router used in
                     sending packets from your network to  the  target  network.
                     Other  routers  are also used if the target network is more
                     than one hop away from your own.

  -FULL              Display information  showing  how  up-to-date  the  routing
                     table  is  (the 'Age' and 'Expiration' columns) in addition
                     to the 'First hop' and  'Hops'  information  shown  by  the
                     -LOCAL option.  -FULL also lists inaccessible networks.

  -CONN              Show which routers are connected to each network, and which
                     other networks those routers touch.  This  option  displays
                     the 'Touching' information.

  -HW                 Display the type of hardware used for each of the networks
                     (ring or IIC).

                     The -CONN and -HW  options  may  take  several  seconds  to
                     execute if you have a large internet.

  -N node-spec        Print  another  node's  view of the internet.  The outputs
                     produced by -LOCAL and -FULL vary from  node  to  node;  -N
                     affects  these  outputs.  The -N option does not affect the
                     output produced by the -CONN  or  -HW  options,  since  the
                     hardware  and  connectivity  do  not  depend  on  a  node's
                     position in the internet.

  -C                 The -C option suppresses the title over each output column.
                     It  also  fills every line of the "Network" column produced
                     by the -CONN option,  and  every  line  of  the  "Hardware"
                     column  produced  by  the  -HW option. These format changes
                     make it easier to use LCNET's output as  another  program's
                     input.


EXAMPLES

  In  this  example, the node is directly connected to network C0FFEE.  Networks
  5A1AD and ED1F1CE were connected in the  past,  but  are  not  now  accessible
  (perhaps because the routers are down).

  The expiration date and time for the 'local' network is meaningless.

  $ lcnet -full
             First
  Network     Hop     Hops    Age  Expiration date/time
  ========   =====   =====    ===  ===================
      B020    4B6F       1    NEW  1985/06/16 14:33:21
    B00B00    4B6F       2    NEW  1985/06/16 14:33:21
     5A1AD    4B6F    gone    NEW  1985/06/16 14:33:21
    C0FFEE       0   local    NEW  1985/06/09 10:27:46
   ED1F1CE    4B6F    gone    NEW  1985/06/16 14:33:21
      D0D0    BAD1       1    NEW  1985/06/16 14:33:39

  The  'Touching'  information describes your internet completely.  This example
  includes several kinds of information:  - Network DEFACED has one router, node
  2A3B.    That  router connects DEFACED to EFFACED.  - Network FACE0FF contains
  two routers, 31DC and 1371.   Those  routers  connect  FACE0FF  to  C0C0A  and
  C0FFEE, respectively.

  $ lcnet -conn
              Touching    Touching
  Network      Router     Network
  ========    ========    ========
      F00D        5C0B       DECAF
                  36CF      C0FFEE
     5A1AD        459B      C0FFEE
                  45BE     ED1F1CE
     B002E        3F0A      C0FFEE
     C0C0A        BAD1      B00B1E
                  56B0     EFFACED
                  31DC     FACE0FF
     DECAF        5C0B        F00D
    B00B1E        BAD1       C0C0A
    C0FFEE        36CF        F00D
                  459B       5A1AD
                  3F0A       B002E
                  1371     FACE0FF
   DEFACED        2A3B     EFFACED
   ED1F1CE        45BE       5A1AD
   EFFACED        56B0       C0C0A
                  2A3B     DEFACED
   FACE0FF        31DC       C0C0A
                  1371      C0FFEE

  $ lcnet -conn -c
      F00D        5C0B       DECAF
      F00D        36CF      C0FFEE
     5A1AD        459B      C0FFEE
     5A1AD        45BE     ED1F1CE
     B002E        3F0A      C0FFEE
     C0C0A        BAD1      B00B1E
     C0C0A        56B0     EFFACED
     C0C0A        31DC     FACE0FF
     DECAF        5C0B        F00D
    B00B1E        BAD1       C0C0A
    C0FFEE        36CF        F00D
    C0FFEE        459B       5A1AD
    C0FFEE        3F0A       B002E
    C0FFEE        1371     FACE0FF
   DEFACED        2A3B     EFFACED
   ED1F1CE        45BE       5A1AD
   EFFACED        56B0       C0C0A
   EFFACED        2A3B     DEFACED
   FACE0FF        31DC       C0C0A
   FACEOFF        1371      C0FFEE


RELATED TOPICS

  More information is available.  Type:

  - HELP LCNODE
   for information on listing connected nodes.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026