Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NAME
       nemesis-udp -- UDP Protocol (The	Nemesis	Project)

SYNOPSIS
       nemesis-udp  [-v6Z?] [-d	IFNAME]	[-c COUNT] [-D ADDR] [-F OPT] [-H MAC]
		   [-I	ID]  [-i  INTERVAL]  [-M  MAC]	[-O  FILE]  [-P	 FILE]
		   [-S ADDR] [-t TOS] [-T TTL] [-x PORT] [-y PORT]

DESCRIPTION
       nemesis is designed to be a command line-based, portable	human IP stack
       for  UNIX-like and Windows systems.  The	suite is broken	down by	proto-
       col, and	should allow for useful	scripting  of  injected	 packets  from
       simple shell scripts.

       nemesis-udp  provides  an interface to craft and	inject UDP packets al-
       lowing the user to specify any portion of  a  UDP  packet  as  well  as
       lower-level IP packet information.

GENERAL	OPTIONS
       -6      Use  IPv6.   When  enabled, the -S ADDR and -D ADDR options are
	       expected	to be IPv6 addresses.

       -c COUNT
	       Number of packets to send, default: 1.

       -i INTERVAL
	       Seconds between repeatedly sent packets,	only available	if  -c
	       is given.

       -v      Display	the injected packet in human readable form.  Use twice
	       to see a	hexdump	of the injected	packet	with  printable	 ASCII
	       characters on the right.	 Use three times for a hexdump without
	       decoded ASCII.

UDP Options
       -P FILE
	       This  will  cause nemesis-udp to	use the	specified payload file
	       as the payload when injecting UDP  packets.   For  packets  in-
	       jected using the	raw interface (where -d	is not used), the max-
	       imum  payload  size is 65415 bytes.  For	packets	injected using
	       the link	layer interface	(where -d IS used), the	 maximum  pay-
	       load  size is 1380 bytes.  Payloads can also be read from stdin
	       by specifying `-P-' instead.

	       Windows systems are limited to a	maximum	payload	size  of  1380
	       bytes for UDP packets.

       -x PORT
	       Specify the source port within the UDP header.

       -y PORT
	       Specify the destintion port within the UDP header.

IP OPTIONS
       -D ADDR
	       Specify the destination IP address within the IP	header.

       -S ADDR
	       Specify the source IP address within the	IP header.

   IPv4	OPTIONS
       -F OPT  Specify the fragmentation options in the	IP header:

		     -FD	don't fragment
		     -FM	more fragments
		     -FR	reserved flag
		     -F	offset

	       IP  fragmentation options can be	specified individually or com-
	       bined into a single argument to the -F command line  switch  by
	       separating  the options with commas (eg.	 -FD,M)	or spaces (eg.
	       -FM 223).  The IP fragmentation offset is a 13-bit  field  with
	       valid  values  from 0 to	8189.  Don't fragment (DF), more frag-
	       ments (MF) and the reserved flag	(RESERVED  or  RB)  are	 1-bit
	       fields.

	       NOTE: Under normal conditions, the reserved flag	is unset.

       -I ID   Specify the IP ID within	the IP header.

       -O FILE
	       This  will  cause  nemesis-udp  to use the specified IP options
	       file as the options when	building the IP	 header	 for  the  in-
	       jected  packet.	 IP  options  can be up	to 40 bytes in length.
	       The IP options file must	be created manually based upon the de-
	       sired options.  IP options can also be read from	stdin by spec-
	       ifying -O- instead.

       -t TOS  Specify the IP type of service  (TOS)  within  the  IP  header.
	       Valid type of service values:

		     2	 Minimize monetary cost
		     4	 Maximize reliability
		     8	 Maximize throughput
		     24	 Minimize delay

	       NOTE:  Under normal conditions, only one	type of	service	is set
	       within a	packet.	 To specify multiple types, specify the	sum of
	       the desired values as the type of service.

       -T TTL  Specify the IP time-to-live (TTL) in the	IP header.

   IPv6	OPTIONS
       -H LIMIT
	       Set hop limit, similar to IPv4 TTL, max 255.

DATA LINK OPTIONS
       -d IFNAME
	       Specify the name	(for UNIX-like systems)	 or  the  number  (for
	       Windows	systems)  of  the IFNAME to use	(eg. fxp0, eth0, hme0,
	       1).

       -H MAC  Specify the source MAC address, (XX:XX:XX:XX:XX:XX).

       -M MAC  Specify the destination MAC address, (XX:XX:XX:XX:XX:XX).

       -Z      Lists the available network interfaces by  number  for  use  in
	       link-layer injection.

	       NOTE: This feature is only relevant to Windows systems.

DIAGNOSTICS
       nemesis-udp returns 0 on	a successful exit, 1 if	it exits on an error.

SEE ALSO
       nemesis-arp(1),	nemesis-dhcp(1),  nemesis-dns(1), nemesis-ethernet(1),
       nemesis-icmp(1),	  nemesis-igmp(1),   nemesis-ip(1),   nemesis-ospf(1),
       nemesis-rip(1), nemesis-tcp(1).

AUTHORS
       Mark Grimes <mark@stateful.net> and
       Jeff Nathan <jeff@snort.org>

BUGS
       Please report at	https://github.com/libnet/nemesis/issues

				 Jul 20, 2021			nemesis-udp(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nemesis-udp&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help