This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
ipprot [2013-12-30 07:50] uls [Installation] |
ipprot [2026-08-09 17:06] (current) uls [-C <connection_log_format>] |
||
|---|---|---|---|
| Line 8: | Line 8: | ||
| transparently forwarded to the destination and returned back to the source. | transparently forwarded to the destination and returned back to the source. | ||
| + | The ipprotd is part of the [[uls:agents:linux]]. | ||
| + | |||
| + | |||
| + | <!-- http://graphviz-dev.appspot.com/ --> | ||
| + | <!-- http://sandbox.kidstrythisathome.com/erdos/ --> | ||
| <graphviz dot left width=700> | <graphviz dot left width=700> | ||
| Line 64: | Line 69: | ||
| <code bash> | <code bash> | ||
| - | ipprotd [-p inport[@listen_host]] [-h out_host] [-P out_port[@out_host]] | + | ipprotd [-p inport[@listen_host]] [-h out_host] [-P out_port[@out_host]] [-b buffsize] |
| - | [-f data_log_file] [-l|-L] [-s] [-z|-j] [-t secs] [-M] [-u cmd] | + | [-f data_log_file] [-l|-L] [-s] [-z|-j] [-t secs] [-M] [-u[T] cmd] |
| [-c connection_log_file] [-C connection_log_format] | [-c connection_log_file] [-C connection_log_format] | ||
| [-r client_ip1 [-r client_ip2 ...]] | [-r client_ip1 [-r client_ip2 ...]] | ||
| - | [-D] [-Dp pid_file] | + | [-D|-Dp pid_file] |
| [-?|-v] | [-?|-v] | ||
| </code> | </code> | ||
| + | ----- | ||
| ==== Options ==== | ==== Options ==== | ||
| Have also a look at the [[ipprot#Examples]]. | Have also a look at the [[ipprot#Examples]]. | ||
| + | |||
| + | |||
| + | === -b <buffsize> === | ||
| + | |||
| + | The default buffer size is 300000 Bytes, that may be to large for some szenarios, | ||
| + | e.g. a client may expect a specific or maximum amount of bytes. | ||
| + | Then specify a smaller <buffsize> in Bytes (the buffer is always placed in memory). | ||
| Line 94: | Line 107: | ||
| Only in combination with option [[ipprot#-c <connection_log_file>]]. | Only in combination with option [[ipprot#-c <connection_log_file>]]. | ||
| - | {| | + | ^ expression ^ is replaced by ^ |
| - | ! expression | + | | %% | % | |
| - | ! is replaced by | + | | %e | date and time of connection end in RFC 3339 format ("yyyy-mm-dd HH:MM:SS+hh:mm") | |
| - | |- | + | | %i | ip address of connection establisher | |
| - | | %% | + | | %n | inserts a newline in the <connection_log_file> | |
| - | | % | + | | %P | complete path to the <connection_log_file> | |
| - | |- | + | | %r | bytes received from connection establisher | |
| - | | %e | + | | %s | date and time of connection start in RFC 3339 format ("yyyy-mm-dd HH:MM:SS+hh:mm") | |
| - | | date and time of connection end in RFC 3339 format ("yyyy-mm-dd HH:MM:SS+hh:mm") | + | | %S | duration of connection in seconds | |
| - | |- | + | | %t | bytes sent to connection establisher | |
| - | | %i | + | | %u | start timestamp of the connection in seconds since Unix epoch | |
| - | | ip address of connection establisher | + | | %U | end timestamp of the connection in seconds since Unix epoch | |
| - | |- | + | |
| - | | %n | + | |
| - | | inserts a newline in the <connection_log_file> | + | |
| - | |- | + | |
| - | | %P | + | |
| - | | complete path to the <connection_log_file> | + | |
| - | |- | + | |
| - | | %r | + | |
| - | | bytes received from connection establisher | + | |
| - | |- | + | |
| - | | %s | + | |
| - | | date and time of connection start in RFC 3339 format ("yyyy-mm-dd HH:MM:SS+hh:mm") | + | |
| - | |- | + | |
| - | | %S | + | |
| - | | duration of connection in seconds | + | |
| - | |- | + | |
| - | | %t | + | |
| - | | bytes sent to connection establisher | + | |
| - | |- | + | |
| - | | %u | + | |
| - | | start timestamp of the connection in seconds since Unix epoch | + | |
| - | |- | + | |
| - | | %U | + | |
| - | | end timestamp of the connection in seconds since Unix epoch | + | |
| - | |} | + | |
| Example: | Example: | ||
| Line 200: | Line 189: | ||
| #848367#1386169176610141 | #848367#1386169176610141 | ||
| #948366#1386169176610343 | #948366#1386169176610343 | ||
| + | |||
| + | You may convert that to a human readable form on most linuxes (remember that the timestamp is in microseconds): | ||
| + | |||
| + | $ date -d@1386169176 '+%F %T' | ||
| + | 2013-12-04 15:59:36 | ||
| Remember that magic number #748369# indicates an iso timestamp which is inserted at regular intervals, see [[ipprot#-t <secs>]]. | Remember that magic number #748369# indicates an iso timestamp which is inserted at regular intervals, see [[ipprot#-t <secs>]]. | ||
| Line 428: | Line 422: | ||
| ==== Installation ==== | ==== Installation ==== | ||
| - | Download the executable {{:uls:ipprotd.zip?linkonly|}}, unpack it and verify the | + | The ipprotd is part of the [[uls:agents:linux]]. |
| - | correct checksum: | + | |
| - | + | ||
| - | <code bash> | + | |
| - | $ unzip ipprotd.zip | + | |
| - | $ sha1sum ipprotd | + | |
| - | ba5b8cba70281c10053d4a16662cd37e7788cba6 ipprotd | + | |
| - | </code> | + | |
| - | + | ||
| - | Place it in directory ''/usr/local/bin'' or ''/usr/bin''. Check if it works (be sure that the directory is in your PATH): | + | |
| - | + | ||
| - | <code bash> | + | |
| - | $ ipprotd -? | + | |
| - | </code> | + | |
| - | + | ||
| - | should give you the help page. | + | |
| - | + | ||
| - | Here are the {{:ipprot:ipprot_2.5.zip?linkonly|sources}}. | + | |