shithub: netgraph

Clone

Last commit

adds service listener fetcher

About

     NETGRAPH(1)                                           NETGRAPH(1)

     NAME
          netgraph - generate a network graph of the Plan 9 system

     SYNOPSIS
          netgraph [ -ipl ] [ -s systuples ] [ -n ipnettuples ] [ -x
          netmtpt ]
          fullnetgraph [ ... ]

     DESCRIPTION
          Netgraph generates a network graph of the Plan 9 system
          based on all data found by the connection service.

          It reads requests from stdin.  Each line has to be one
          request tuple in the format type=what, for example
          sys=cirno. Currently valid requests are:

          for systems:
               sys, ip, dom, ipgw.

          for ipnets:
               ipnet.

          Netgraph will try to find relevant fields for each system
          and ipnet.  You can use the -s and -n parameters to adjust
          the default list of fields.

          In addition to that, netgraph supports the following parame-
          ters:

          -i   By default, netgraph hides fields that are derived from
               the ipnet in the system visualization.  This flag can
               be used to include all relevant ipnet values.

          -p   Netgraph outputs a PostScript file by default.  This
               flag pipes that output through ps2pdf with the proper
               parameters set to have the correct page size.  The out-
               put format will be PDF.

               It is equivalent to running netgraph | ps2pdf
               -g1191x842 -r72, but the size adjusts automatically to
               the actual drawing.

          -l   Netgraph tries to fetch a list of network listeners
               based on files in /cfg/$sysname/service.

          -x   Use this flag to use a different network device.

          -s systuples
               The user can adjust the relevant fields to search for
               by providing a comma separated list of field names.

          -n ipnettuples
               This is analog to -s, but for ipnets.

          Fullnetgraph is a rc shell script that calls netgraph with
          all sys= tuples that could be found in /lib/ndb/local. It
          forwards all arguments to netgraph.

     EXAMPLES
          Save the full graph of the Plan 9 network to a PDF file:

               fullnetgraph -p > everything.pdf

          Display the network around computer cirno:

               echo 'sys=cirno' | netgraph -p | page

     SOURCE
          https://shithub.us/sirjofri/netgraph/HEAD/info.html.

     SEE ALSO
          ndb(8), ps2pdf(1)

     BUGS
          Sure. Send patches.