Documentation/customports.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Custom Information</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
   9 "><LINK
  10 REL="HOME"
  11 TITLE="IPTraf User's Manual"
  12 HREF="manual.html"><LINK
  13 REL="UP"
  14 TITLE="Configuring IPTraf"
  15 HREF="config.html"><LINK
  16 REL="PREVIOUS"
  17 TITLE="Timers"
  18 HREF="timers.html"><LINK
  19 REL="NEXT"
  20 TITLE="Background Operation"
  21 HREF="backop.html"></HEAD
  22 ><BODY
  23 CLASS="SECT1"
  24 BGCOLOR="#FFFFFF"
  25 TEXT="#000000"
  26 LINK="#0000FF"
  27 VLINK="#840084"
  28 ALINK="#0000FF"
  29 ><DIV
  30 CLASS="NAVHEADER"
  31 ><TABLE
  32 WIDTH="100%"
  33 BORDER="0"
  34 CELLPADDING="0"
  35 CELLSPACING="0"
  36 ><TR
  37 ><TH
  38 COLSPAN="3"
  39 ALIGN="center"
  40 >IPTraf User's Manual</TH
  41 ></TR
  42 ><TR
  43 ><TD
  44 WIDTH="10%"
  45 ALIGN="left"
  46 VALIGN="bottom"
  47 ><A
  48 HREF="timers.html"
  49 >&#60;&#60;&#60; Previous</A
  50 ></TD
  51 ><TD
  52 WIDTH="80%"
  53 ALIGN="center"
  54 VALIGN="bottom"
  55 >Configuring IPTraf</TD
  56 ><TD
  57 WIDTH="10%"
  58 ALIGN="right"
  59 VALIGN="bottom"
  60 ><A
  61 HREF="backop.html"
  62 >Next &#62;&#62;&#62;</A
  63 ></TD
  64 ></TR
  65 ></TABLE
  66 ><HR
  67 ALIGN="LEFT"
  68 WIDTH="100%"></DIV
  69 ><DIV
  70 CLASS="SECT1"
  71 ><H1
  72 CLASS="SECT1"
  73 ><A
  74 NAME="CUSTOMPORTS"
  75 >Custom Information</A
  76 ></H1
  77 ><P
  78 >  The remaining configuration items allow you to enter information which
  79   IPTraf uses for its displays and logs.</P
  80 ><DIV
  81 CLASS="SECT2"
  82 ><H2
  83 CLASS="SECT2"
  84 ><A
  85 NAME="AEN2061"
  86 >Additional ports</A
  87 ></H2
  88 ><P
  89 >Select this item to enter a port
  90   number to be included in the TCP/UDP counts in the TCP/UDP service
  91   statistics main menu item described above. By default,
  92   port numbers above 1023 are not monitored. If you do
  93   have a higher-numbered port to monitor, enter it here.</P
  94 ><P
  95 >  You will see two fields. If you have only one port to enter, just fill
  96   up the first field. To specify a range, fill both fields, the first port
  97   in the first field, the last port in the second field.</P
  98 ><P
  99 >  You can select this option multiple times to add more values or ranges.</P
 100 ></DIV
 101 ><DIV
 102 CLASS="SECT2"
 103 ><H2
 104 CLASS="SECT2"
 105 ><A
 106 NAME="AEN2066"
 107 >Delete port/range</A
 108 ></H2
 109 ><P
 110 >  Select this item to remove a higher-numbered port number or
 111   port range you entered earlier with the <I
 112 CLASS="EMPHASIS"
 113 >Additional
 114   ports...</I
 115 > option. A window will come up
 116   containing the entered ports and ranges. Select the entry you want
 117   delete and press Enter.</P
 118 ></DIV
 119 ><DIV
 120 CLASS="SECT2"
 121 ><H2
 122 CLASS="SECT2"
 123 ><A
 124 NAME="AEN2070"
 125 >LAN Station Identifiers</A
 126 ></H2
 127 ><P
 128 > The LAN station statistics facility monitors stations based
 129   on their respective MAC addresses. The hexadecimal notation of these
 130   addresses make them even more difficult to remember than the
 131   dotted-decimal IP addresses, so these facilities were added to
 132   help you better determine which station is which.</P
 133 ><P
 134 >  Selecting the <I
 135 CLASS="EMPHASIS"
 136 >Ethernet/PLIP host descriptions...</I
 137 > or
 138   <I
 139 CLASS="EMPHASIS"
 140 >FDDI/Token Ring host descriptions...</I
 141 > options brings
 142   up a submenu asking you to add, edit, or delete descriptions.</P
 143 ><P
 144 >  To add a new description, select the <I
 145 CLASS="EMPHASIS"
 146 >Add
 147 description...</I
 148 > option. A dialog
 149   box will appear, asking you for the MAC address and an appropriate
 150   description. Type in the address in hexadecimal notation with no
 151   punctuation of any kind. The dialog box is
 152   case-insensitive for the address; the alphabetical digits A to F will be
 153   stored in lowercase.</P
 154 ><P
 155 >  Use the Tab key to move between fields and Enter to accept. Press Ctrl+X
 156   to discard this dialog and return to the main menu.</P
 157 ><P
 158 >  The description may be anything: the IP address, a fully-qualified
 159   domain name, or a description of your liking as long
 160   as the field can hold.</P
 161 ><P
 162 >  Enter as many descriptions as you need. Press Ctrl+X at a blank dialog
 163   after you have entered the last entry</P
 164 ><P
 165 >  These descriptions will be displayed alongside the MAC addresses
 166   in the LAN station monitor, together with the type of frame (Ethernet,
 167   PLIP, or FDDI).</P
 168 ><P
 169 >  An existing address or description may be edited
 170 by selecting the <I
 171 CLASS="EMPHASIS"
 172 >Edit
 173   description...</I
 174 > option from the submenu. A panel will appear with a list
 175   of existing address descriptions. Select the one you wish to
 176   edit and press Enter. A dialog box identical to that
 177   when you add a description will appear with prefilled fields. Just
 178   backspace over and edit the fields. Press Enter to accept or Ctrl+X to
 179   cancel.</P
 180 ><P
 181 >  Selecting the <I
 182 CLASS="EMPHASIS"
 183 >Delete description...</I
 184 > submenu
 185   item brings up the selection panel. Select the description you want to
 186   delete and press Enter. You can also press Ctrl+X to cancel the operation.</P
 187 ><P
 188 >  IPTraf 2.4 and later also recognizes the <TT
 189 CLASS="FILENAME"
 190 >/etc/ethers</TT
 191 > file.
 192   Should a hardware address be present in the IPTraf definition files and
 193   in <TT
 194 CLASS="FILENAME"
 195 >/etc/ethers</TT
 196 >, the IPTraf definition will be used.</P
 197 ><DIV
 198 CLASS="NOTE"
 199 ><P
 200 ></P
 201 ><TABLE
 202 CLASS="NOTE"
 203 WIDTH="100%"
 204 BORDER="0"
 205 ><TR
 206 ><TD
 207 WIDTH="25"
 208 ALIGN="CENTER"
 209 VALIGN="TOP"
 210 ><IMG
 211 SRC="./stylesheet-images/note.gif"
 212 HSPACE="5"
 213 ALT="Note"></TD
 214 ><TH
 215 ALIGN="LEFT"
 216 VALIGN="CENTER"
 217 ><B
 218 >Note</B
 219 ></TH
 220 ></TR
 221 ><TR
 222 ><TD
 223 >&nbsp;</TD
 224 ><TD
 225 ALIGN="LEFT"
 226 VALIGN="TOP"
 227 ><P
 228 >  The description file for Ethernet and PLIP is
 229   <TT
 230 CLASS="FILENAME"
 231 >ethernet.desc</TT
 232 >, while the FDDI and Token Ring mappings are stored
 233   in <TT
 234 CLASS="FILENAME"
 235 >fddi.desc</TT
 236 > in the IPTraf working directory. These files are in
 237   colon-delimited text format. Database engines or custom scripts can be
 238   told to append data lines to those files. Each line follows this
 239   simple format:</P
 240 ><TABLE
 241 BORDER="0"
 242 BGCOLOR="#E0E0E0"
 243 WIDTH="100%"
 244 ><TR
 245 ><TD
 246 ><PRE
 247 CLASS="SYNOPSIS"
 248 ><TT
 249 CLASS="REPLACEABLE"
 250 ><I
 251 >address</I
 252 ></TT
 253 >:<TT
 254 CLASS="REPLACEABLE"
 255 ><I
 256 >description</I
 257 ></TT
 258 ></PRE
 259 ></TD
 260 ></TR
 261 ></TABLE
 262 ><P
 263 >
 264  For example</P
 265 ><TABLE
 266 BORDER="0"
 267 BGCOLOR="#E0E0E0"
 268 WIDTH="100%"
 269 ><TR
 270 ><TD
 271 ><PRE
 272 CLASS="SYNOPSIS"
 273 >00201e457e:Cisco 3640 gateway</PRE
 274 ></TD
 275 ></TR
 276 ></TABLE
 277 ><P
 278 >  Do not put colons, periods, or any invalid characters in the MAC address.</P
 279 ></TD
 280 ></TR
 281 ></TABLE
 282 ></DIV
 283 ></DIV
 284 ></DIV
 285 ><DIV
 286 CLASS="NAVFOOTER"
 287 ><HR
 288 ALIGN="LEFT"
 289 WIDTH="100%"><TABLE
 290 WIDTH="100%"
 291 BORDER="0"
 292 CELLPADDING="0"
 293 CELLSPACING="0"
 294 ><TR
 295 ><TD
 296 WIDTH="33%"
 297 ALIGN="left"
 298 VALIGN="top"
 299 ><A
 300 HREF="timers.html"
 301 >&#60;&#60;&#60; Previous</A
 302 ></TD
 303 ><TD
 304 WIDTH="34%"
 305 ALIGN="center"
 306 VALIGN="top"
 307 ><A
 308 HREF="manual.html"
 309 >Home</A
 310 ></TD
 311 ><TD
 312 WIDTH="33%"
 313 ALIGN="right"
 314 VALIGN="top"
 315 ><A
 316 HREF="backop.html"
 317 >Next &#62;&#62;&#62;</A
 318 ></TD
 319 ></TR
 320 ><TR
 321 ><TD
 322 WIDTH="33%"
 323 ALIGN="left"
 324 VALIGN="top"
 325 >Timers</TD
 326 ><TD
 327 WIDTH="34%"
 328 ALIGN="center"
 329 VALIGN="top"
 330 ><A
 331 HREF="config.html"
 332 >Up</A
 333 ></TD
 334 ><TD
 335 WIDTH="33%"
 336 ALIGN="right"
 337 VALIGN="top"
 338 >Background Operation</TD
 339 ></TR
 340 ></TABLE
 341 ></DIV
 342 ></BODY
 343 ></HTML
 344 >