1HOSTS3D(1) General Commands Manual HOSTS3D(1)
2
6 hosts3d - 3D real-time network monitor
7
9 hosts3d [-f]
10
12 Hosts3D is a 3D real-time network monitor, displaying hosts and packet
13 traffic. Features include support for multiple sensors, analysis of
14 packets to gather hostnames and services, configurable layout of sub‐
15 networks, recording/replaying of packet traffic, and the ability to
16 filter packets by hosts, protocol or port.
17 -f Display full screen.
19 Press H key in Hosts3D to show help.
21
23 Created in directory ".hosts3d/".
24 controls.txt Controls
26 settings-hsd Settings
28 0network.hnl Network Layout On-Exit
30 1network.hnl Network Layout 1
32 2network.hnl Network Layout 2
34 3network.hnl Network Layout 3
36 4network.hnl Network Layout 4
38 netpos.txt CIDR Notation Net Position/Colour
40 traffic.hpt Packet Traffic Record
42 tmp-hinfo-hsd Temporary Information
44 tmp-netpos-hsd Temporary Net Positions
46 tmp-flist-hsd Temporary Working Directory File List
48
50 If a host is not a member of any net position entries, it is placed in
51 the Grey Zone. If a host is a member of multiple net position entries,
52 the first entry is used. Line format for net position entries is "pos
53 net x-position y-position z-position colour",
54 eg. "pos 123.123.123.123/32 10 0 -10 green".
55 Positions:
57 Grey/Red positive x-position
59 Blue/Green negative x-position
61 Up positive y-position
63 Down negative y-position
65 Grey/Blue positive z-position
67 Red/Green negative z-position
69 Colours:
71 none (where multiple colours are used), default (grey), orange, yellow,
73 fluro, green, mint, aqua, blue, purple, violet and hold (place hosts in
74 same position).
75
77 If sudo is required to start/stop a local hsen, the user starting
78 Hosts3D must be in /etc/sudoers. The default command to stop a local
79 hsen is "killall hsen", which will kill all hsen processes.
80
82 Firewall configuration: hsen talks to Hosts3D via UDP port 10111. If
83 hsen is running and Hosts3D is not, ICMP Port Unreachable (UDP port
84 10111) may be generated. Hosts3D logs to syslog, check when trou‐
85 bleshooting. By default hosts are added from packet source IP address,
86 activate Add Destination Hosts to also add from destination IP address.
87 Anomalies are a new host or host service. Using the menu options to
88 move/arrange a few thousand hosts may take a few minutes. Deleting
89 hosts, using the menu options to move/arrange hosts, or clear‐
90 ing/restoring a net layout may affect packet recording. Clicking a
91 multiple host object will cycle through selecting hosts within. Data
92 files from 32-bit version are incompatible with 64-bit version and vice
93 versa.
94
96 hsen(1)
97
99 Written by Del Castle.
100
102 Report bugs to <hosts3d@gmail.com>.
103
105 Copyright (c) 2006-2010 Del Castle
106 This program is free software; you can redistribute it and/or modify it
107 under the terms of the GNU General Public License as published by the
108 Free Software Foundation; either version 2 of the License, or (at your
109 option) any later version.
110 This program is distributed in the hope that it will be useful, but
111 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
112 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
113 Public License for more details.
114 29 Jun 10 HOSTS3D(1)