1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN">
8 CONTENT=
"Modular DocBook HTML Stylesheet Version 1.64
11 TITLE=
"IPTraf User's Manual"
12 HREF=
"manual.html"><LINK
14 TITLE=
"Background Operation"
15 HREF=
"backop.html"><LINK
17 TITLE=
" rvnamed Messages"
18 HREF=
"rvnamedmessages.html"></HEAD
37 >IPTraf User's Manual
</TH
46 ><<< Previous
</A
58 HREF=
"rvnamedmessages.html"
59 >Next
>>></A
74 >IPTraf's messages are presented in two ways. In interactive mode, messages
75 are displayed in a distictive message box. In daemon (background) mode,
76 appropriate messages are written to the
<TT
80 file in the IPTraf log directory (normally
94 CLASS=
"SIMPLEMSGENTRY"
100 CLASS=
"COMPUTEROUTPUT"
101 >Unable to create config file
</TT
105 > IPTraf cannot create the configuration file. The most likely cause of
106 this is that you didn't properly install the
107 program, and the necessary directory
110 >/var/local/iptraf
</TT
112 exist. Can also be generated if you have a disk problem or if you
113 have too many files open.
</BLOCKQUOTE
116 CLASS=
"SIMPLEMSGENTRY"
122 CLASS=
"COMPUTEROUTPUT"
123 >Unable to read config file
</TT
127 > The configuration record cannot be read. You most likely have a disk
131 CLASS=
"SIMPLEMSGENTRY"
137 CLASS=
"COMPUTEROUTPUT"
138 >Unable to write config file
</TT
142 > The configuration file cannot be written. You either have a disk
143 problem, or (more likely), your disk is full.
</BLOCKQUOTE
146 CLASS=
"SIMPLEMSGENTRY"
152 CLASS=
"COMPUTEROUTPUT"
153 >Enter an appropriate description for this filter
</TT
157 > Enter something to clearly describe the filter you are defining.
</BLOCKQUOTE
160 CLASS=
"SIMPLEMSGENTRY"
166 CLASS=
"COMPUTEROUTPUT"
167 >Error loading filter list file
</TT
171 > IPTraf cannot access the list of defined TCP or UDP filters. Can also be
172 an indicator of a bad disk.
</BLOCKQUOTE
175 CLASS=
"SIMPLEMSGENTRY"
181 CLASS=
"COMPUTEROUTPUT"
182 >Error writing filter list file
</TT
186 > The filter list file cannot be written to. You may
187 have trouble accessing your filters.
</BLOCKQUOTE
190 CLASS=
"SIMPLEMSGENTRY"
196 CLASS=
"COMPUTEROUTPUT"
197 >Unable to read TCP/UDP/misc IP filter file
</TT
201 > IPTraf cannot read the filter data off the file. Could be caused
202 by a bad disk.
</BLOCKQUOTE
205 CLASS=
"SIMPLEMSGENTRY"
211 CLASS=
"COMPUTEROUTPUT"
212 >Error opening filter data file
</TT
216 > IPTraf cannot open the filter file. Could be caused by a shortage of
217 file descriptors or a bad disk.
</BLOCKQUOTE
220 CLASS=
"SIMPLEMSGENTRY"
226 CLASS=
"COMPUTEROUTPUT"
227 >Unable to write filter data
</TT
231 > IPTraf cannot add the newly defined filter to the filter list. This may
232 be due to a bad disk.
</BLOCKQUOTE
235 CLASS=
"SIMPLEMSGENTRY"
241 CLASS=
"COMPUTEROUTPUT"
242 >Cannot create filter data file
</TT
246 > IPTraf cannot create the filter record file. The defined filter is lost.
</BLOCKQUOTE
249 CLASS=
"SIMPLEMSGENTRY"
255 CLASS=
"COMPUTEROUTPUT"
256 >Unable to save filter changes
</TT
260 > IPTraf cannot save the changes you made to the filter. You probably
261 have a disk error.
</BLOCKQUOTE
264 CLASS=
"SIMPLEMSGENTRY"
270 CLASS=
"COMPUTEROUTPUT"
271 >Unable to write filter state information
</TT
275 > The current state of the filters cannot be saved. IPTraf will be unable
276 to correctly reload the filters the next time it's started. This can
277 be caused by a bad disk or improper installation.
</BLOCKQUOTE
280 CLASS=
"SIMPLEMSGENTRY"
286 CLASS=
"COMPUTEROUTPUT"
287 >Unable to save interface flags
</TT
291 > IPTraf was unable to save the flags of the network interfaces. This is
292 probably due to a bad installation or full filesystem.
</BLOCKQUOTE
295 CLASS=
"SIMPLEMSGENTRY"
301 CLASS=
"COMPUTEROUTPUT"
302 >Unable to retrieve saved interface flags
</TT
306 > IPTraf was unable to retrieve the save interface flags.
307 Probably again due to a bad installation or full filesystem.
</BLOCKQUOTE
310 CLASS=
"SIMPLEMSGENTRY"
316 CLASS=
"COMPUTEROUTPUT"
322 > filter data file in use; try again later
</TT
326 CLASS=
"COMPUTEROUTPUT"
327 >Filter state file in use; try again later
</TT
331 > Another IPTraf process is modifying the TCP, UDP or miscellaneous IP
332 filter data or the filter state file and has locked the files
333 or file. Try again once the other IPTraf process has terminated or
334 completed its modifications and unlocked the files.
</BLOCKQUOTE
337 CLASS=
"SIMPLEMSGENTRY"
343 CLASS=
"COMPUTEROUTPUT"
344 >Unable to resolve hostname
</TT
348 > The indicated host name in the filter cannot be resolved into an
349 IP address. Check the local hosts database
<TT
353 your machine's DNS configuration or DNS server. The filter parameters will not be used.
</BLOCKQUOTE
356 CLASS=
"SIMPLEMSGENTRY"
362 CLASS=
"COMPUTEROUTPUT"
363 >Unable to open host description file
</TT
367 > IPTraf cannot open the file containing the descriptions for Ethernet
368 or FDDI addresses. Could be due to a bad disk or a hit on the file
369 descriptor limit.
</BLOCKQUOTE
372 CLASS=
"SIMPLEMSGENTRY"
378 CLASS=
"COMPUTEROUTPUT"
379 >Unable to write host description
</TT
383 > IPTraf was unable to write the description record for this Ethernet or
384 FDDI address. Could be due to a bad disk or corrupted filesystem.
</BLOCKQUOTE
387 CLASS=
"SIMPLEMSGENTRY"
393 CLASS=
"COMPUTEROUTPUT"
394 >No descriptions
</TT
398 > You tried to edit or delete a description with no previous
399 descriptions defined.
</BLOCKQUOTE
402 CLASS=
"SIMPLEMSGENTRY"
408 CLASS=
"COMPUTEROUTPUT"
409 >Cannot open log file
</TT
413 > There is a problem opening the log file. There is most
414 likely a problem with the disk, or there are too many open files.
</BLOCKQUOTE
417 CLASS=
"SIMPLEMSGENTRY"
423 CLASS=
"COMPUTEROUTPUT"
424 >Unable to obtain interface list
</TT
428 > IPTraf was unable to retrieve the list of network interfaces
432 > filesystem. This may be due
433 to a badly configured kernel. IPTraf needs
<TT
437 filesystem support.
</BLOCKQUOTE
440 CLASS=
"SIMPLEMSGENTRY"
446 CLASS=
"COMPUTEROUTPUT"
447 >No active interfaces. Check their status or the /proc filesystem.
</TT
451 > IPTraf found no active interfaces. Either all interfaces are down or the
455 > file was empty or unavailable. Activate at least one
456 interface or check the
<TT
459 > file.
</BLOCKQUOTE
462 CLASS=
"SIMPLEMSGENTRY"
468 CLASS=
"COMPUTEROUTPUT"
469 >Unable to obtain interface parameters for interface
</TT
473 > The system call to retrieve the interface's flags failed. Check your
474 interface or kernel driver.
</BLOCKQUOTE
477 CLASS=
"SIMPLEMSGENTRY"
483 CLASS=
"COMPUTEROUTPUT"
484 >Promisc change failed for interface
</TT
488 > The system call to change the promiscuous flag failed. Check
489 your interface or its kernel driver.
</BLOCKQUOTE
492 CLASS=
"SIMPLEMSGENTRY"
498 CLASS=
"COMPUTEROUTPUT"
499 >Unable to open raw socket for flag change
</TT
503 > IPTraf was unable to open the necessary socket for the promiscuous
504 change operation. May be due to a shortage of file descriptors.
</BLOCKQUOTE
507 CLASS=
"SIMPLEMSGENTRY"
513 CLASS=
"COMPUTEROUTPUT"
514 >Unable to open socket for MTU determination
</TT
518 > Returned by the facility for detailed interface statistics
519 if the raw socket's opening sequence failed. The facility will abort.
</BLOCKQUOTE
522 CLASS=
"SIMPLEMSGENTRY"
528 CLASS=
"COMPUTEROUTPUT"
529 >Unable to open raw socket
</TT
533 > IPTraf was unable to open the raw socket for packet capture. May be due
534 to a shortage of file descriptors.
<DIV
548 SRC=
"./stylesheet-images/note.gif"
565 > IPTraf
2.x.x requires Linux kernel
2.2.x, with the Packet
566 Socket option compiled in or installed as a module. IPTraf
2.x will
567 return this error on a pre-
2.2 kernel or on a
2.2 kernel without
576 CLASS=
"SIMPLEMSGENTRY"
582 CLASS=
"COMPUTEROUTPUT"
583 >Unable to obtain interface MTU
</TT
587 > The detailed statistics facility was unable to
588 obtain the maximum transmission unit (MTU) for the selected
589 interface. The facility will abort.
</BLOCKQUOTE
592 CLASS=
"SIMPLEMSGENTRY"
598 CLASS=
"COMPUTEROUTPUT"
599 >Specified interface not supported
</TT
603 > The interface specified with the
<TT
604 CLASS=
"COMPUTEROUTPUT"
608 CLASS=
"COMPUTEROUTPUT"
611 CLASS=
"COMPUTEROUTPUT"
614 CLASS=
"COMPUTEROUTPUT"
618 CLASS=
"COMPUTEROUTPUT"
620 > command-line parameters is not supported
621 by IPTraf.
</BLOCKQUOTE
624 CLASS=
"SIMPLEMSGENTRY"
630 CLASS=
"COMPUTEROUTPUT"
631 >Specified interface not active
</TT
635 > The interface specified with the
<TT
636 CLASS=
"COMPUTEROUTPUT"
640 CLASS=
"COMPUTEROUTPUT"
644 CLASS=
"COMPUTEROUTPUT"
647 CLASS=
"COMPUTEROUTPUT"
651 CLASS=
"COMPUTEROUTPUT"
653 > command-line parameters is
654 supported, but not currently activated.
</BLOCKQUOTE
657 CLASS=
"SIMPLEMSGENTRY"
663 CLASS=
"COMPUTEROUTPUT"
664 >Fatal: memory allocation error
</TT
668 > May occur if you have too little memory to allocate for windows, the
669 menu system, or dialog boxes. IPTraf tries
670 to prevent further allocations if memory runs out during a
671 monitor. However, this could also mean a bug if you're reasonably sure
672 you're not out of memory. An instructional message
673 on bug reporting follows this message.
<DIV
687 SRC=
"./stylesheet-images/note.gif"
704 >This is actually a response to the
705 segmentation fault error (SIGSEGV).
</P
713 CLASS=
"SIMPLEMSGENTRY"
719 CLASS=
"COMPUTEROUTPUT"
720 >This program can be run only by the system administrator
</TT
724 > IPTraf normally does not allow anybody but uid
0 (root) to run it.
725 This measure is included for safety reasons. See the section
726 on recompiling the program below if you want to override this.
727 This feature is built in, and not part of the configuration
</BLOCKQUOTE
730 CLASS=
"SIMPLEMSGENTRY"
736 CLASS=
"COMPUTEROUTPUT"
737 >Your TERM variable is not set
</TT
744 > (terminal type) environment variable
745 must be set to a valid terminal type so that the screen management
746 routines can function properly. Set it to the appropriate terminal type.
747 Linux consoles typically have their
<TT
752 CLASS=
"COMPUTEROUTPUT"
757 CLASS=
"SIMPLEMSGENTRY"
763 CLASS=
"COMPUTEROUTPUT"
764 >Received TERM signal
</TT
768 > Not related to the previous message. The
770 CLASS=
"COMPUTEROUTPUT"
773 is normally used to gracefully shut down a program. This message
774 simply indicates that the
<TT
775 CLASS=
"COMPUTEROUTPUT"
777 > signal was caught and IPTraf is
778 attempting to shut down as gracefully as possible.
</BLOCKQUOTE
781 CLASS=
"SIMPLEMSGENTRY"
787 CLASS=
"COMPUTEROUTPUT"
788 > Invalid option or missing parameter, use iptraf -h for help
</TT
793 CLASS=
"COMPUTEROUTPUT"
797 CLASS=
"COMPUTEROUTPUT"
801 CLASS=
"COMPUTEROUTPUT"
804 CLASS=
"COMPUTEROUTPUT"
808 CLASS=
"COMPUTEROUTPUT"
810 > options were specified but
811 no interface was specified on the command line. These
812 parameters require a valid interface name (or
814 CLASS=
"COMPUTEROUTPUT"
817 CLASS=
"COMPUTEROUTPUT"
821 CLASS=
"COMPUTEROUTPUT"
823 >). This message also appears if an unknown option is passed
827 > command.
</BLOCKQUOTE
830 CLASS=
"SIMPLEMSGENTRY"
836 CLASS=
"COMPUTEROUTPUT"
837 >Warning: unable to tag this process
</TT
841 > IPTraf normally tags itself when it runs to prevent multiple instances
842 of the statistical facilities from running.
843 This message means the program was unable to
844 create the necessary tag file. This may be due to a bad or
845 improper installation. Try running the
853 > in the distribution's top-level directory.
</BLOCKQUOTE
856 CLASS=
"SIMPLEMSGENTRY"
862 CLASS=
"COMPUTEROUTPUT"
863 >Warning: unable to tag facility
</TT
867 > IPTraf was unable to create the tag file for the facility you
868 started. The facility will still run, but other instances of IPTraf that
869 may be running simultaneously will allow the same facility to run.
870 This may cause both instances of the facility to malfunction. This could
871 be due to a bad disk or bad installation.
</BLOCKQUOTE
874 CLASS=
"SIMPLEMSGENTRY"
880 CLASS=
"COMPUTEROUTPUT"
886 > already running/listening on interface
</TT
890 > The facility you tried to start is currently running
891 on the indicated interface in another IPTraf process on the machine.
892 This restriction is placed to prevent conflicts involving
893 internal sockets or the log files.
</BLOCKQUOTE
896 CLASS=
"SIMPLEMSGENTRY"
902 CLASS=
"COMPUTEROUTPUT"
903 >General interface statistics already active in another process
</TT
907 > Only one instance of the general interface statistics can run at a time.
</BLOCKQUOTE
910 CLASS=
"SIMPLEMSGENTRY"
916 CLASS=
"COMPUTEROUTPUT"
917 >Duplicate port/range entry
</TT
921 > You entered a port number or range that was already added to the list of
922 additional ports to be monitored by the TCP/UDP service monitor
</BLOCKQUOTE
925 CLASS=
"SIMPLEMSGENTRY"
931 CLASS=
"COMPUTEROUTPUT"
936 > There are no ports or port ranges earlier added. There's nothing
937 to delete.
</BLOCKQUOTE
940 CLASS=
"SIMPLEMSGENTRY"
946 CLASS=
"COMPUTEROUTPUT"
947 >Can't start rvnamed; lookups will block
</TT
951 > IPTraf cannot start the
<B
954 > daemon; probably due
955 to a bad installation. IPTraf will fall back to blocking lookups.
</BLOCKQUOTE
958 CLASS=
"SIMPLEMSGENTRY"
964 CLASS=
"COMPUTEROUTPUT"
965 >Can't spawn new process; lookups will block
</TT
969 > IPTraf cannot start a new process. This may be due to memory shortage.
970 IPTraf will fall back to blocking lookups.
</BLOCKQUOTE
973 CLASS=
"SIMPLEMSGENTRY"
979 CLASS=
"COMPUTEROUTPUT"
980 >Fork error, IPTraf cannot run in background
</TT
984 > IPTraf cannot start a new process, and can go into the background.
985 This may be due to memory shortage. IPTraf aborts.
</BLOCKQUOTE
988 CLASS=
"SIMPLEMSGENTRY"
994 CLASS=
"COMPUTEROUTPUT"
995 >No memory for new filter entry
</TT
999 > IPTraf was unable to allocate memory for a new filter entry. Most likely
1000 due to memory shortage.
</BLOCKQUOTE
1003 CLASS=
"SIMPLEMSGENTRY"
1009 CLASS=
"COMPUTEROUTPUT"
1014 > This indicator appears if memory runs low due to a lot of entries in a
1015 facility. Should critical functions fail (window creation,
1016 internal allocation), the program could terminate with a
1017 segmentation violation.
<DIV
1031 SRC=
"./stylesheet-images/note.gif"
1048 > Any message or indicator about low memory means that your system
1049 does not have enough memory to handle the entries. It is
1050 almost certain that sooner or later, IPTraf or other applications will
1051 abort due to the failure of important system calls or library functions.
1052 Memory must be added right away.
</P
1060 CLASS=
"SIMPLEMSGENTRY"
1066 CLASS=
"COMPUTEROUTPUT"
1071 > This indicator appears if an error occurs receiving data
1075 > program (IPC stands for Interprocess Communication).
1076 This indication should not occur under normal circumstances.
1077 Report instances of this condition and the circumstances under which
1078 it happens. You may also include data from the
1082 > file.
</BLOCKQUOTE
1085 CLASS=
"SIMPLEMSGENTRY"
1091 CLASS=
"COMPUTEROUTPUT"
1092 >Error opening terminal:
<TT
1101 > The screen management routines cannot find the
1106 terminal. IPTraf expects the terminfo database located
1109 >/usr/share/terminfo
</TT
1110 >. This error could occur when your terminfo
1111 database is located somewhere else. See the section on controlling the
<TT
1114 > search path.
</BLOCKQUOTE
1117 CLASS=
"SIMPLEMSGENTRY"
1123 CLASS=
"COMPUTEROUTPUT"
1124 >This will end your IPTraf session
1129 >In interactive mode IPTraf asks you to confirm your exit
1130 command. Press Enter to return to the shell or any other key to cancel
1131 your command and return to the main menu.
</BLOCKQUOTE
1151 ><<< Previous
</A
1166 HREF=
"rvnamedmessages.html"
1167 >Next
>>></A
1175 >Background Operation
</TD
1185 >rvnamed Messages
</TD