NETSED(1) | NetSED | NETSED(1) |
netsed - a network stream editor.
netsed {proto} {lport} {rhost} {rport} {rule} [rule ...]
netsed is a small and handy utility to alter, in real time, the contents of packets forwarded in a network stream, or in a datagram connection. When called with a set of replacement rules, these rules are tested for applicability to each packet entering in either direction.
proto
lport
rhost
As a special case, assigning "0" to rhost will insert the kernel's knowledge of the targeted host address, in a situation where a netfilter rule is redirecting traffic. This happens when running a transparent proxy service.
rport
Also here a value "0" will be acceptable to arrange a transparent proxy service, as the kernel's tracking will provide the intended remote port number.
rule
s/pat1/pat2[/flag]
The effect is to replace the text that matches pat1 with the expansion of pat2. The optional parameter flag is a composite containing a numerical value limiting the maximal number of times the rule can be applied, or a direction semaphore indicating that the rule applies only to incoming (coded as 'I' or 'i') or outgoing ('O' or 'o') traffic. One could say that the rule expires after num occurrences.
The rules are applied in succession to all passing packets, flowing in either direction. As soon as a rule has been expired, it is removed from the collection of active rules for the current connection. Observe that any counter is started as the connection is initiated, running as long as the connection is alive.
This holds directly for TCP connections, whereas for UDP a connection is considered to consist of incoming data on fixed address and fixed port together with any response from a remote server. When no datagrams have been transmitted for a period of 30 seconds, the UPD connection is seen as closed.
A single rule is limited to act on individual packets; a pattern can not match across packet boundaries.
Using HTTP-like escape sequences for hexadecimal values, all eight-bit characters are viable in the patterns. Thus the standard character pair CRNL would code as "%0a%0d". In a pattern, the percentage sign itself must be escaped by duplication. Thus a string "%%" is interpreted in a pattern as a literal percentage sign.
A handful replacement rules are handy as examples.
s/andrew/mike
s/andrew/mike/1
s/andrew/mike%00%00
s/%%/%2f/20
s/Rilke/Proust/o, s/Proust/Rilke/i
This text was initially compiled by Mats Erik Andersson as a Docbook source from the usage printout. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, version 2, or of a later version.
Copyright © 2010-2014 Mats Erik Andersson
May 23rd, 2014 | NetSED 1.2 |