libnet-functions.h man page on SuSE

Man page or keyword search:  
man Server   14857 pages
apropos Keyword Search (all sections)
Output format
SuSE logo
[printable version]

libnet-functions.h(3)					 libnet-functions.h(3)

NAME
       libnet-functions.h - libnet exported function prototypes

SYNOPSIS
   Functions
       libnet_t * libnet_init (int injection_type, char *device, char
	   *err_buf)
       void libnet_destroy (libnet_t *l)
       void libnet_clear_packet (libnet_t *l)
       void libnet_stats (libnet_t *l, struct libnet_stats *ls)
       int libnet_getfd (libnet_t *l)
       int8_t * libnet_getdevice (libnet_t *l)
       u_int8_t * libnet_getpbuf (libnet_t *l, libnet_ptag_t ptag)
       u_int32_t libnet_getpbuf_size (libnet_t *l, libnet_ptag_t ptag)
       char * libnet_geterror (libnet_t *l)
       u_int32_t libnet_getpacket_size (libnet_t *l)
       int libnet_seed_prand (libnet_t *l)
       u_int32_t libnet_get_prand (int mod)
       int libnet_toggle_checksum (libnet_t *l, libnet_ptag_t ptag, int mode)
       char * libnet_addr2name4 (u_int32_t in, u_int8_t use_name)
       u_int32_t libnet_name2addr4 (libnet_t *l, char *host_name, u_int8_t
	   use_name)
       libnet_in6_addr libnet_name2addr6 (libnet_t *l, char *host_name,
	   u_int8_t use_name)
       void libnet_addr2name6_r (struct libnet_in6_addr addr, u_int8_t
	   use_name, char *host_name, int host_name_len)
       int libnet_plist_chain_new (libnet_t *l, libnet_plist_t **plist, char
	   *token_list)
       int libnet_plist_chain_next_pair (libnet_plist_t *plist, u_int16_t
	   *bport, u_int16_t *eport)
       int libnet_plist_chain_dump (libnet_plist_t *plist)
       char * libnet_plist_chain_dump_string (libnet_plist_t *plist)
       int libnet_plist_chain_free (libnet_plist_t *plist)
       libnet_ptag_t libnet_build_802_1q (u_int8_t *dst, u_int8_t *src,
	   u_int16_t tpi, u_int8_t priority, u_int8_t cfi, u_int16_t vlan_id,
	   u_int16_t len_proto, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_802_1x (u_int8_t eap_ver, u_int8_t eap_type,
	   u_int16_t length, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_802_2 (u_int8_t dsap, u_int8_t ssap,
	   u_int8_t control, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_802_2snap (u_int8_t dsap, u_int8_t ssap,
	   u_int8_t control, u_int8_t *oui, u_int16_t type, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_802_3 (u_int8_t *dst, u_int8_t *src,
	   u_int16_t len, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ethernet (u_int8_t *dst, u_int8_t *src,
	   u_int16_t type, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_ethernet (u_int8_t *dst, u_int16_t type,
	   libnet_t *l)
       libnet_ptag_t libnet_build_fddi (u_int8_t fc, u_int8_t *dst, u_int8_t
	   *src, u_int8_t dsap, u_int8_t ssap, u_int8_t cf, u_int8_t *org,
	   u_int16_t type, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_fddi (u_int8_t fc, u_int8_t *dst,
	   u_int8_t dsap, u_int8_t ssap, u_int8_t cf, u_int8_t *org, u_int16_t
	   type, libnet_t *l)
       libnet_ptag_t libnet_build_arp (u_int16_t hrd, u_int16_t pro, u_int8_t
	   hln, u_int8_t pln, u_int16_t op, u_int8_t *sha, u_int8_t *spa,
	   u_int8_t *tha, u_int8_t *tpa, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_arp (u_int16_t op, u_int8_t *sha,
	   u_int8_t *spa, u_int8_t *tha, u_int8_t *tpa, libnet_t *l)
       libnet_ptag_t libnet_build_tcp (u_int16_t sp, u_int16_t dp, u_int32_t
	   seq, u_int32_t ack, u_int8_t control, u_int16_t win, u_int16_t sum,
	   u_int16_t urg, u_int16_t len, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_tcp_options (u_int8_t *options, u_int32_t
	   options_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_udp (u_int16_t sp, u_int16_t dp, u_int16_t
	   len, u_int16_t sum, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_cdp (u_int8_t version, u_int8_t ttl,
	   u_int16_t sum, u_int16_t type, u_int16_t len, u_int8_t *value,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_icmpv4_echo (u_int8_t type, u_int8_t code,
	   u_int16_t sum, u_int16_t id, u_int16_t seq, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_icmpv4_mask (u_int8_t type, u_int8_t code,
	   u_int16_t sum, u_int16_t id, u_int16_t seq, u_int32_t mask,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_icmpv4_unreach (u_int8_t type, u_int8_t
	   code, u_int16_t sum, u_int16_t orig_len, u_int8_t orig_tos,
	   u_int16_t orig_id, u_int16_t orig_frag, u_int8_t orig_ttl, u_int8_t
	   orig_prot, u_int16_t orig_check, u_int32_t orig_src, u_int32_t
	   orig_dst, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_icmpv4_redirect (u_int8_t type, u_int8_t
	   code, u_int16_t sum, u_int32_t gateway, u_int16_t orig_len,
	   u_int8_t orig_tos, u_int16_t orig_id, u_int16_t orig_frag, u_int8_t
	   orig_ttl, u_int8_t orig_prot, u_int16_t orig_check, u_int32_t
	   orig_src, u_int32_t orig_dst, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_icmpv4_timeexceed (u_int8_t type, u_int8_t
	   code, u_int16_t sum, u_int16_t orig_len, u_int8_t orig_tos,
	   u_int16_t orig_id, u_int16_t orig_frag, u_int8_t orig_ttl, u_int8_t
	   orig_prot, u_int16_t orig_check, u_int32_t orig_src, u_int32_t
	   orig_dst, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_icmpv4_timestamp (u_int8_t type, u_int8_t
	   code, u_int16_t sum, u_int16_t id, u_int16_t seq, n_time otime,
	   n_time rtime, n_time ttime, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_igmp (u_int8_t type, u_int8_t code,
	   u_int16_t sum, u_int32_t ip, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipv4 (u_int16_t len, u_int8_t tos, u_int16_t
	   id, u_int16_t frag, u_int8_t ttl, u_int8_t prot, u_int16_t sum,
	   u_int32_t src, u_int32_t dst, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipv4_options (u_int8_t *options, u_int32_t
	   options_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_ipv4 (u_int16_t len, u_int8_t prot,
	   u_int32_t dst, libnet_t *l)
       libnet_ptag_t libnet_build_ipv6 (u_int8_t tc, u_int32_t fl, u_int16_t
	   len, u_int8_t nh, u_int8_t hl, struct libnet_in6_addr src, struct
	   libnet_in6_addr dst, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipv6_frag (u_int8_t nh, u_int8_t reserved,
	   u_int16_t frag, u_int32_t id, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipv6_routing (u_int8_t nh, u_int8_t len,
	   u_int8_t rtype, u_int8_t segments, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipv6_destopts (u_int8_t nh, u_int8_t len,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_ipv6_hbhopts (u_int8_t nh, u_int8_t len,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_autobuild_ipv6 (u_int16_t len, u_int8_t nh, struct
	   libnet_in6_addr dst, libnet_t *l)
       libnet_ptag_t libnet_build_isl (u_int8_t *dhost, u_int8_t type,
	   u_int8_t user, u_int8_t *shost, u_int16_t len, u_int8_t *snap,
	   u_int16_t vid, u_int16_t index, u_int16_t reserved, u_int8_t
	   *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipsec_esp_hdr (u_int32_t spi, u_int32_t seq,
	   u_int32_t iv, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipsec_esp_ftr (u_int8_t len, u_int8_t nh,
	   int8_t *auth, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ipsec_ah (u_int8_t nh, u_int8_t len,
	   u_int16_t res, u_int32_t spi, u_int32_t seq, u_int32_t auth,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_dnsv4 (u_int16_t h_len, u_int16_t id,
	   u_int16_t flags, u_int16_t num_q, u_int16_t num_anws_rr, u_int16_t
	   num_auth_rr, u_int16_t num_addi_rr, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_rip (u_int8_t cmd, u_int8_t version,
	   u_int16_t rd, u_int16_t af, u_int16_t rt, u_int32_t addr, u_int32_t
	   mask, u_int32_t next_hop, u_int32_t metric, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_rpc_call (u_int32_t rm, u_int32_t xid,
	   u_int32_t prog_num, u_int32_t prog_vers, u_int32_t procedure,
	   u_int32_t cflavor, u_int32_t clength, u_int8_t *cdata, u_int32_t
	   vflavor, u_int32_t vlength, u_int8_t *vdata, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_stp_conf (u_int16_t id, u_int8_t version,
	   u_int8_t bpdu_type, u_int8_t flags, u_int8_t *root_id, u_int32_t
	   root_pc, u_int8_t *bridge_id, u_int16_t port_id, u_int16_t
	   message_age, u_int16_t max_age, u_int16_t hello_time, u_int16_t
	   f_delay, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_stp_tcn (u_int16_t id, u_int8_t version,
	   u_int8_t bpdu_type, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_token_ring (u_int8_t ac, u_int8_t fc,
	   u_int8_t *dst, u_int8_t *src, u_int8_t dsap, u_int8_t ssap,
	   u_int8_t cf, u_int8_t *org, u_int16_t type, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_token_ring (u_int8_t ac, u_int8_t fc,
	   u_int8_t *dst, u_int8_t dsap, u_int8_t ssap, u_int8_t cf, u_int8_t
	   *org, u_int16_t type, libnet_t *l)
       libnet_ptag_t libnet_build_vrrp (u_int8_t version, u_int8_t type,
	   u_int8_t vrouter_id, u_int8_t priority, u_int8_t ip_count, u_int8_t
	   auth_type, u_int8_t advert_int, u_int16_t sum, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_mpls (u_int32_t label, u_int8_t
	   experimental, u_int8_t bos, u_int8_t ttl, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ntp (u_int8_t leap_indicator, u_int8_t
	   version, u_int8_t mode, u_int8_t stratum, u_int8_t poll, u_int8_t
	   precision, u_int16_t delay_int, u_int16_t delay_frac, u_int16_t
	   dispersion_int, u_int16_t dispersion_frac, u_int32_t reference_id,
	   u_int32_t ref_ts_int, u_int32_t ref_ts_frac, u_int32_t orig_ts_int,
	   u_int32_t orig_ts_frac, u_int32_t rec_ts_int, u_int32_t
	   rec_ts_frac, u_int32_t xmt_ts_int, u_int32_t xmt_ts_frac, u_int8_t
	   *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2 (u_int16_t len, u_int8_t type,
	   u_int32_t rtr_id, u_int32_t area_id, u_int16_t sum, u_int16_t
	   autype, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_hello (u_int32_t netmask, u_int16_t
	   interval, u_int8_t opts, u_int8_t priority, u_int dead_int,
	   u_int32_t des_rtr, u_int32_t bkup_rtr, u_int32_t neighbor, u_int8_t
	   *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_dbd (u_int16_t dgram_len, u_int8_t
	   opts, u_int8_t type, u_int seqnum, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsr (u_int type, u_int lsid,
	   u_int32_t advrtr, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsu (u_int num, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsa (u_int16_t age, u_int8_t opts,
	   u_int8_t type, u_int lsid, u_int32_t advrtr, u_int seqnum,
	   u_int16_t sum, u_int16_t len, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsa_rtr (u_int16_t flags, u_int16_t
	   num, u_int id, u_int data, u_int8_t type, u_int8_t tos, u_int16_t
	   metric, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsa_net (u_int32_t nmask, u_int
	   rtrid, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsa_sum (u_int32_t nmask, u_int
	   metric, u_int tos, u_int8_t *payload, u_int32_t payload_s, libnet_t
	   *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_ospfv2_lsa_as (u_int32_t nmask, u_int
	   metric, u_int32_t fwdaddr, u_int tag, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_data (u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_dhcpv4 (u_int8_t opcode, u_int8_t htype,
	   u_int8_t hlen, u_int8_t hopcount, u_int32_t xid, u_int16_t secs,
	   u_int16_t flags, u_int32_t cip, u_int32_t yip, u_int32_t sip,
	   u_int32_t gip, u_int8_t *chaddr, u_int8_t *sname, u_int8_t *file,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_bootpv4 (u_int8_t opcode, u_int8_t htype,
	   u_int8_t hlen, u_int8_t hopcount, u_int32_t xid, u_int16_t secs,
	   u_int16_t flags, u_int32_t cip, u_int32_t yip, u_int32_t sip,
	   u_int32_t gip, u_int8_t *chaddr, u_int8_t *sname, u_int8_t *file,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       u_int32_t libnet_getgre_length (u_int16_t fv)
       libnet_ptag_t libnet_build_gre (u_int16_t fv, u_int16_t type, u_int16_t
	   sum, u_int16_t offset, u_int32_t key, u_int32_t seq, u_int16_t len,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_egre (u_int16_t fv, u_int16_t type,
	   u_int16_t sum, u_int16_t offset, u_int32_t key, u_int32_t seq,
	   u_int16_t len, u_int8_t *payload, u_int32_t payload_s, libnet_t *l,
	   libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_gre_sre (u_int16_t af, u_int8_t offset,
	   u_int8_t length, u_int8_t *routing, u_int8_t *payload, u_int32_t
	   payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_gre_last_sre (libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_bgp4_header (u_int8_t
	   marker[LIBNET_BGP4_MARKER_SIZE], u_int16_t len, u_int8_t type,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_bgp4_open (u_int8_t version, u_int16_t
	   src_as, u_int16_t hold_time, u_int32_t bgp_id, u_int8_t opt_len,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_bgp4_update (u_int16_t unfeasible_rt_len,
	   u_int8_t *withdrawn_rt, u_int16_t total_path_attr_len, u_int8_t
	   *path_attributes, u_int16_t info_len, u_int8_t *reachability_info,
	   u_int8_t *payload, u_int32_t payload_s, libnet_t *l, libnet_ptag_t
	   ptag)
       libnet_ptag_t libnet_build_bgp4_notification (u_int8_t err_code,
	   u_int8_t err_subcode, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_sebek (u_int32_t magic, u_int16_t version,
	   u_int16_t type, u_int32_t counter, u_int32_t time_sec, u_int32_t
	   time_usec, u_int32_t pid, u_int32_t uid, u_int32_t fd, u_int8_t
	   cmd[SEBEK_CMD_LENGTH], u_int32_t length, u_int8_t *payload,
	   u_int32_t payload_s, libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_build_link (u_int8_t *dst, u_int8_t *src, u_int8_t
	   *oui, u_int16_t type, u_int8_t *payload, u_int32_t payload_s,
	   libnet_t *l, libnet_ptag_t ptag)
       libnet_ptag_t libnet_autobuild_link (u_int8_t *dst, u_int8_t *oui,
	   u_int16_t type, libnet_t *l)
       int libnet_write (libnet_t *l)
       u_int32_t libnet_get_ipaddr4 (libnet_t *l)
       libnet_in6_addr libnet_get_ipaddr6 (libnet_t *l)
       libnet_ether_addr * libnet_get_hwaddr (libnet_t *l)
       u_int8_t * libnet_hex_aton (int8_t *s, int *len)
       int libnet_adv_cull_packet (libnet_t *l, u_int8_t **packet, u_int32_t
	   *packet_s)
       int libnet_adv_cull_header (libnet_t *l, libnet_ptag_t ptag, u_int8_t
	   **header, u_int32_t *header_s)
       int libnet_adv_write_link (libnet_t *l, u_int8_t *packet, u_int32_t
	   packet_s)
       void libnet_adv_free_packet (libnet_t *l, u_int8_t *packet)
       int libnet_cq_add (libnet_t *l, char *label)
       libnet_t * libnet_cq_remove (libnet_t *l)
       libnet_t * libnet_cq_remove_by_label (char *label)
       int8_t * libnet_cq_getlabel (libnet_t *l)
       libnet_t * libnet_cq_find_by_label (char *label)
       void libnet_cq_destroy ()
       libnet_t * libnet_cq_head ()
       int libnet_cq_last ()
       libnet_t * libnet_cq_next ()
       u_int32_t libnet_cq_size ()
       void libnet_diag_dump_context (libnet_t *l)
       void libnet_diag_dump_pblock (libnet_t *l)
       char * libnet_diag_dump_pblock_type (u_int8_t type)
       void libnet_diag_dump_hex (u_int8_t *packet, u_int32_t len, int swap,
	   FILE *stream)
       int libnet_write_raw_ipv4 (libnet_t *l, u_int8_t *packet, u_int32_t
	   size)
       int libnet_write_raw_ipv6 (libnet_t *l, u_int8_t *packet, u_int32_t
	   size)
       int libnet_write_link (libnet_t *l, u_int8_t *packet, u_int32_t size)
       int libnet_open_raw4 (libnet_t *l)
       int libnet_close_raw4 (libnet_t *l)
       int libnet_open_raw6 (libnet_t *l)
       int libnet_close_raw6 (libnet_t *l)
       int libnet_select_device (libnet_t *l)
       int libnet_open_link (libnet_t *l)
       int libnet_close_link (libnet_t *l)
       int libnet_do_checksum (libnet_t *l, u_int8_t *packet, int protocol,
	   int len)
       u_int32_t libnet_compute_crc (u_int8_t *buf, u_int32_t len)
       u_int16_t libnet_ip_check (u_int16_t *addr, int len)
       int libnet_in_cksum (u_int16_t *addr, int len)
       libnet_pblock_t * libnet_pblock_probe (libnet_t *l, libnet_ptag_t ptag,
	   u_int32_t n, u_int8_t type)
       libnet_pblock_t * libnet_pblock_new (libnet_t *l, u_int32_t size)
       int libnet_pblock_swap (libnet_t *l, libnet_ptag_t ptag1, libnet_ptag_t
	   ptag2)
       int libnet_pblock_insert_before (libnet_t *l, libnet_ptag_t ptag1,
	   libnet_ptag_t ptag2)
       void libnet_pblock_delete (libnet_t *l, libnet_pblock_t *p)
       libnet_ptag_t libnet_pblock_update (libnet_t *l, libnet_pblock_t *p,
	   u_int32_t h, u_int8_t type)
       libnet_pblock_t * libnet_pblock_find (libnet_t *l, libnet_ptag_t ptag)
       int libnet_pblock_append (libnet_t *l, libnet_pblock_t *p, u_int8_t
	   *buf, u_int32_t len)
       void libnet_pblock_setflags (libnet_pblock_t *p, u_int8_t flags)
       int libnet_pblock_p2p (u_int8_t type)
       int libnet_pblock_coalesce (libnet_t *l, u_int8_t **packet, u_int32_t
	   *size)
       int libnet_check_iface (libnet_t *l)

   Variables
       const  struct libnet_in6_addr in6addr_error

Detailed Description
       libnet exported function prototypes

Function Documentation
   char* libnet_addr2name4 (u_int32_t in, u_int8_t use_name)
       Takes a network byte ordered IPv4 address and returns a pointer to
       either a canonical DNS name (if it has one) or a string of dotted
       decimals. This may incur a DNS lookup if the hostname and mode is set
       to LIBNET_RESOLVE. If mode is set to LIBNET_DONT_RESOLVE, no DNS lookup
       will be performed and the function will return a pointer to a dotted
       decimal string. The function cannot fail -- if no canonical name
       exists, it will fall back on returning a dotted decimal string. This
       function is non-reentrant.

       Parameters:
	   in network byte ordered IPv4 address
	   use_name LIBNET_RESOLVE or LIBNET_DONT_RESOLVE

       Returns:
	   a pointer to presentation format string

   void libnet_addr2name6_r (struct libnet_in6_addr addr, u_int8_t use_name,
       char * host_name, int host_name_len)
       Should document this baby right here.

   int libnet_adv_cull_header (libnet_t * l, libnet_ptag_t ptag, u_int8_t **
       header, u_int32_t * header_s)
       [Advanced Interface] Pulls the header from the specified ptag from the
       given libnet context. This function is part of the advanced interface
       and is only available when libnet is initialized in advanced mode. If
       the function fails libnet_geterror() can tell you why.

       Parameters:
	   l pointer to a libnet context
	   ptag the ptag referencing the header to pull
	   header will contain the header
	   header_s will contain the header size

       Returns:
	   1 on success, -1 on failure

   int libnet_adv_cull_packet (libnet_t * l, u_int8_t ** packet, u_int32_t *
       packet_s)
       [Advanced Interface] Yanks a prebuilt, wire-ready packet from the given
       libnet context. If libnet was configured to do so (which it is by
       default) the packet will have all checksums written in. This function
       is part of the advanced interface and is only available when libnet is
       initialized in advanced mode. It is important to note that the function
       performs an implicit malloc() and a corresponding call to
       libnet_adv_free_packet() should be made to free the memory packet
       occupies. If the function fails libnet_geterror() can tell you why.

       Parameters:
	   l pointer to a libnet context
	   packet will contain the wire-ready packet
	   packet_s will contain the packet size

       Returns:
	   1 on success, -1 on failure

   void libnet_adv_free_packet (libnet_t * l, u_int8_t * packet)
       [Advanced Interface] Frees the memory allocated when
       libnet_adv_cull_packet() is called.

       Parameters:
	   l pointer to a libnet context
	   packet a pointer to the packet to free

   int libnet_adv_write_link (libnet_t * l, u_int8_t * packet, u_int32_t
       packet_s)
       [Advanced Interface] Writes a packet the network at the link layer.
       This function is useful to write a packet that has been constructed by
       hand by the application programmer or, more commonly, to write a packet
       that has been returned by a call to libnet_adv_cull_packet(). This
       function is part of the advanced interface and is only available when
       libnet is initialized in advanced mode. If the function fails
       libnet_geterror() can tell you why.

       Parameters:
	   l pointer to a libnet context
	   packet a pointer to the packet to inject
	   packet_s the size of the packet

       Returns:
	   the number of bytes written, or -1 on failure

   libnet_ptag_t libnet_autobuild_arp (u_int16_t op, u_int8_t * sha, u_int8_t
       * spa, u_int8_t * tha, u_int8_t * tpa, libnet_t * l)
       Autouilds an Address Resolution Protocol (ARP) header. Depending on the
       op value, the function builds one of several different types of RFC 826
       or RFC 903 RARP packets.

       Parameters:
	   op ARP operation type
	   sha sender's hardware address
	   spa sender's protocol address
	   tha target hardware address
	   tpa targer protocol address
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_ethernet (u_int8_t * dst, u_int16_t type,
       libnet_t * l)
       Autobuilds an Ethernet header. The RFC 894 Ethernet II header is almost
       identical to the IEEE 802.3 header, with the exception that the field
       immediately following the source address holds the layer 3 protocol (as
       opposed to frame's length). You should only use this function when
       libnet is initialized with the LIBNET_LINK interface.

       Parameters:
	   dst destination ethernet address
	   type upper layer protocol type
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_fddi (u_int8_t fc, u_int8_t * dst, u_int8_t
       dsap, u_int8_t ssap, u_int8_t cf, u_int8_t * org, u_int16_t type,
       libnet_t * l)
       Autobuilds a Fiber Distributed Data Interface (FDDI) header.

       Parameters:
	   fc class format and priority	 dst destination fddi address
	   dsap destination service access point
	   ssap source service access point
	   cf cf
	   org IEEE organizational code
	   type upper layer protocol
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_ipv4 (u_int16_t len, u_int8_t prot,
       u_int32_t dst, libnet_t * l)
       Autobuilds a version 4 Internet Protocol (IP) header. The function is
       useful * to build an IP header quickly when you do not need a granular
       level of control. The function takes the same len, prot, and dst
       arguments as libnet_build_ipv4(). The function does not accept a ptag
       argument, but it does return a ptag. In other words, you can use it to
       build a new IP header but not to modify an existing one.

       Parameters:
	   len total length of the IP packet including all subsequent data
	   prot upper layer protocol
	   dst destination IPv4 address (little endian)
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_ipv6 (u_int16_t len, u_int8_t nh, struct
       libnet_in6_addr dst, libnet_t * l)
       This function is not yet implement and is a NONOP.

       Parameters:
	   len length
	   nh next header
	   dst destination IPv6 address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_link (u_int8_t * dst, u_int8_t * oui,
       u_int16_t type, libnet_t * l)
       Automatically builds a link layer header for an initialized l. The
       function determines the proper link layer header format from how l was
       initialized. The function current supports Ethernet and Token Ring link
       layers.

       Parameters:
	   dst the destination MAC address
	   oui Organizationally Unique Identifier (unused for Ethernet)
	   type the upper layer protocol type
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_autobuild_token_ring (u_int8_t ac, u_int8_t fc,
       u_int8_t * dst, u_int8_t dsap, u_int8_t ssap, u_int8_t cf, u_int8_t *
       org, u_int16_t type, libnet_t * l)
       Auto-builds a token ring header.

       Parameters:
	   ac access control
	   fc frame control
	   dst destination address
	   dsap destination service access point
	   ssap source service access point
	   cf control field
	   oui Organizationally Unique Identifier
	   type upper layer protocol type
	   l pointer to a libnet context

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_802_1q (u_int8_t * dst, u_int8_t * src,
       u_int16_t tpi, u_int8_t priority, u_int8_t cfi, u_int16_t vlan_id,
       u_int16_t len_proto, u_int8_t * payload, u_int32_t payload_s, libnet_t
       * l, libnet_ptag_t ptag)
       Builds an IEEE 802.1q VLAN tagging header. Depending on the value of
       len_proto, the function wraps the 802.1q header inside either an IEEE
       802.3 header or an RFC 894 Ethernet II (DIX) header (both resulting in
       an 18-byte frame). If len is 1500 or less, most receiving protocol
       stacks parse the frame as an IEEE 802.3 encapsulated frame. If len is
       one of the Ethernet type values, most protocol stacks parse the frame
       as an RFC 894 Ethernet II encapsulated frame. Note the length value is
       calculated without the 802.1q header of 18 bytes.

       Parameters:
	   dst pointer to a six byte source ethernet address
	   src pointer to a six byte destination ethernet address
	   tpi tag protocol identifier
	   priority priority
	   cfi canonical format indicator
	   vlan_id vlan identifier
	   len_proto length (802.3) protocol (Ethernet II)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_802_1x (u_int8_t eap_ver, u_int8_t eap_type,
       u_int16_t length, u_int8_t * payload, u_int32_t payload_s, libnet_t *
       l, libnet_ptag_t ptag)
       Builds an IEEE 802.1x extended authentication protocol header.

       Parameters:
	   eap_ver the EAP version
	   eap_type the EAP type
	   length frame length
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_802_2 (u_int8_t dsap, u_int8_t ssap, u_int8_t
       control, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an IEEE 802.2 LLC header.

       Parameters:
	   dsap destination service access point
	   ssap source service access point
	   control control field
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_802_2snap (u_int8_t dsap, u_int8_t ssap,
       u_int8_t control, u_int8_t * oui, u_int16_t type, u_int8_t * payload,
       u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an IEEE 802.2 LLC SNAP header.

       Parameters:
	   dsap destination service access point
	   ssap source service access point
	   control control field
	   oui Organizationally Unique Identifier
	   type upper layer protocol
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_802_3 (u_int8_t * dst, u_int8_t * src, u_int16_t
       len, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an IEEE 802.3 header. The 802.3 header is almost identical to
       the RFC 894 Ethernet II header, the exception being that the field
       immediately following the source address holds the frame's length (as
       opposed to the layer 3 protocol). You should only use this function
       when libnet is initialized with the LIBNET_LINK interface.

       Parameters:
	   dst destination ethernet address
	   src source ethernet address
	   len frame length sans header
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_arp (u_int16_t hrd, u_int16_t pro, u_int8_t hln,
       u_int8_t pln, u_int16_t op, u_int8_t * sha, u_int8_t * spa, u_int8_t *
       tha, u_int8_t * tpa, u_int8_t * payload, u_int32_t payload_s, libnet_t
       * l, libnet_ptag_t ptag)
       Builds an Address Resolution Protocol (ARP) header. Depending on the op
       value, the function builds one of several different types of RFC 826 or
       RFC 903 RARP packets.

       Parameters:
	   hrd hardware address format
	   pro protocol address format
	   hln hardware address length
	   pln protocol address length
	   op ARP operation type
	   sha sender's hardware address
	   spa sender's protocol address
	   tha target hardware address
	   tpa targer protocol address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_bgp4_header (u_int8_t
       marker[LIBNET_BGP4_MARKER_SIZE], u_int16_t len, u_int8_t type, u_int8_t
       * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 1771 Border Gateway Protocol 4 (BGP-4) header. The
       primary function of a BGP speaking system is to exchange network
       reachability information with other BGP systems. This network
       reachability information includes information on the list of Autonomous
       Systems (ASs) that reachability information traverses. This information
       is sufficient to construct a graph of AS connectivity from which
       routing loops may be pruned and some policy decisions at the AS level
       may be enforced. This function builds the base BGP header which is used
       as a preamble before any other BGP header. For example, a BGP KEEPALIVE
       message may be built with only this function, while an error
       notification requires a subsequent call to
       libnet_build_bgp4_notification.

       Parameters:
	   marker a value the receiver can predict (if the message type is not
	   BGP OPEN, or no authentication is used, these 16 bytes are normally
	   set as all ones)
	   len total length of the BGP message, including the header
	   type type code of the message (OPEN, UPDATE, NOTIFICATION or
	   KEEPALIVE)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_bgp4_notification (u_int8_t err_code, u_int8_t
       err_subcode, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an RFC 1771 Border Gateway Protocol 4 (BGP-4) notification
       header. A NOTIFICATION message is sent when an error condition is
       detected. Specific error information may be passed through the payload
       interface.

       Parameters:
	   err_code type of notification
	   err_subcode more specific information about the reported error.
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_bgp4_open (u_int8_t version, u_int16_t src_as,
       u_int16_t hold_time, u_int32_t bgp_id, u_int8_t opt_len, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 1771 Border Gateway Protocol 4 (BGP-4) OPEN header. This
       is the first message sent by each side of a BGP connection. The
       optional parameters options should be constructed using the payload
       interface (see RFC 1771 for the options structures).

       Parameters:
	   version protocol version (should be set to 4)
	   src_as Autonomous System of the sender
	   hold_time used to compute the maximum allowed time between the
	   receipt of KEEPALIVE, and/or UPDATE messages by the sender
	   bgp_id BGP identifier of the sender
	   opt_len total length of the optional parameters field in bytes
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_bgp4_update (u_int16_t unfeasible_rt_len,
       u_int8_t * withdrawn_rt, u_int16_t total_path_attr_len, u_int8_t *
       path_attributes, u_int16_t info_len, u_int8_t * reachability_info,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Builds an RFC 1771 Border Gateway Protocol 4 (BGP-4) update header.
       Update messages are used to transfer routing information between BGP
       peers.

       Parameters:
	   unfeasible_rt_len indicates the length of the (next) 'withdrawn
	   routes' field in bytes
	   withdrawn_rt list of IP addresses prefixes for the routes that are
	   being withdrawn; each IP address prefix is built as a 2-tuple
	   <length (1 byte), prefix (variable)>
	   total_path_attr_len indicates the length of the (next) 'path
	   attributes' field in bytes
	   path_attributes each attribute is a 3-tuple <type (2 bytes),
	   length, value>
	   info_len indicates the length of the (next) 'network layer
	   reachability information' field in bytes (needed for internal
	   memory size calculation)
	   reachability_info 2-tuples <length (1 byte), prefix (variable)>.
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_bootpv4 (u_int8_t opcode, u_int8_t htype,
       u_int8_t hlen, u_int8_t hopcount, u_int32_t xid, u_int16_t secs,
       u_int16_t flags, u_int32_t cip, u_int32_t yip, u_int32_t sip, u_int32_t
       gip, u_int8_t * chaddr, u_int8_t * sname, u_int8_t * file, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_cdp (u_int8_t version, u_int8_t ttl, u_int16_t
       sum, u_int16_t type, u_int16_t len, u_int8_t * value, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a Cisco Discovery Protocol (CDP) header. Cisco Systems designed
       CDP to aid in the network management of adjacent Cisco devices. The CDP
       protocol specifies data by using a type/length/value (TLV) setup. The
       first TLV can specified by using the functions type, length, and value
       arguments. To specify additional TLVs, the programmer could either use
       the payload interface or libnet_build_data() to construct them.

       Parameters:
	   version CDP version
	   ttl time to live (time information should be cached by recipient)
	   sum checksum (0 for libnet to autofill)
	   type type of data contained in value
	   len length of value arugment
	   value the CDP information string
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_data (u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds a generic libnet protocol header. This is useful for including
       an optional payload to a packet that might need to change repeatedly
       inside of a loop.

       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_dhcpv4 (u_int8_t opcode, u_int8_t htype,
       u_int8_t hlen, u_int8_t hopcount, u_int32_t xid, u_int16_t secs,
       u_int16_t flags, u_int32_t cip, u_int32_t yip, u_int32_t sip, u_int32_t
       gip, u_int8_t * chaddr, u_int8_t * sname, u_int8_t * file, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_dnsv4 (u_int16_t h_len, u_int16_t id, u_int16_t
       flags, u_int16_t num_q, u_int16_t num_anws_rr, u_int16_t num_auth_rr,
       u_int16_t num_addi_rr, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 1035 version 4 DNS header. Additional DNS payload
       information should be specified using the payload interface.

       Parameters:
	   id DNS packet id
	   flags control flags
	   num_q number of questions
	   num_anws_rr number of answer resource records
	   num_auth_rr number of authority resource records
	   num_addi_rr number of additional resource records
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_egre (u_int16_t fv, u_int16_t type, u_int16_t
       sum, u_int16_t offset, u_int32_t key, u_int32_t seq, u_int16_t len,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Generic Routing Encapsulation (GRE - RFC 1701) is used to encapsulate
       any protocol. Hence, the IP part of the packet is usually referred as
       'delivery header'. It is then followed by the GRE header and finally
       the encapsulated packet (IP or whatever). As GRE is very modular, the
       first GRE header describes the structure of the header, using bits and
       flag to specify which fields will be present in the header.

       Parameters:
	   fv the 16 0 to 7: which fields are included in the header
	   (checksum, seq. number, key, ...), bits 8 to 12: flag, bits 13 to
	   15: version.
	   payload optional payload or NULL
	   type which protocol is encapsulated (PPP, IP, ...)
	   sum checksum (0 for libnet to autofill).
	   offset byte offset from the start of the routing field to the first
	   byte of the SRE
	   key inserted by the encapsulator to authenticate the source
	   seq sequence number used by the receiver to sort the packets
	   len size of the GRE packet
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ethernet (u_int8_t * dst, u_int8_t * src,
       u_int16_t type, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an Ethernet header. The RFC 894 Ethernet II header is almost
       identical to the IEEE 802.3 header, with the exception that the field
       immediately following the source address holds the layer 3 protocol (as
       opposed to frame's length). You should only use this function when
       libnet is initialized with the LIBNET_LINK interface.

       Parameters:
	   dst destination ethernet address
	   src source ethernet address
	   type upper layer protocol type
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_fddi (u_int8_t fc, u_int8_t * dst, u_int8_t *
       src, u_int8_t dsap, u_int8_t ssap, u_int8_t cf, u_int8_t * org,
       u_int16_t type, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds a Fiber Distributed Data Interface (FDDI) header.

       Parameters:
	   fc class format and priority	 dst destination fddi address  src
	   source fddi address
	   dsap destination service access point
	   ssap source service access point
	   cf cf
	   org 3 byte IEEE organizational code
	   type upper layer protocol
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_gre (u_int16_t fv, u_int16_t type, u_int16_t
       sum, u_int16_t offset, u_int32_t key, u_int32_t seq, u_int16_t len,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Generic Routing Encapsulation (GRE - RFC 1701) is used to encapsulate
       any protocol. Hence, the IP part of the packet is usually referred as
       'delivery header'. It is then followed by the GRE header and finally
       the encapsulated packet (IP or whatever). As GRE is very modular, the
       first GRE header describes the structure of the header, using bits and
       flag to specify which fields will be present in the header.

       Parameters:
	   fv the 16 0 to 7: which fields are included in the header
	   (checksum, seq. number, key, ...), bits 8 to 12: flag, bits 13 to
	   15: version.
	   payload optional payload or NULL
	   type which protocol is encapsulated (PPP, IP, ...)
	   sum checksum (0 for libnet to autofill).
	   offset byte offset from the start of the routing field to the first
	   byte of the SRE
	   key inserted by the encapsulator to authenticate the source
	   seq sequence number used by the receiver to sort the packets
	   len size of the GRE packet
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_gre_last_sre (libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_gre_sre (u_int16_t af, u_int8_t offset, u_int8_t
       length, u_int8_t * routing, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_echo (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int16_t id, u_int16_t seq, u_int8_t * payload,
       u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Control Message Protocol (ICMP)
       echo request/reply header

       Parameters:
	   type type of ICMP packet (should be ICMP_ECHOREPLY or ICMP_ECHO)
	   code code of ICMP packet (should be 0)
	   sum checksum (0 for libnet to autofill)
	   id identification number
	   seq packet sequence number
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_mask (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int16_t id, u_int16_t seq, u_int32_t mask, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Control Message Protocol (ICMP)
       IP netmask request/reply header.

       Parameters:
	   type type of ICMP packet (should be ICMP_MASKREQ or ICMP_MASKREPLY)
	   code code of ICMP packet (should be 0)
	   sum checksum (0 for libnet to autofill)
	   id identification number
	   seq packet sequence number
	   mask subnet mask
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_redirect (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int32_t gateway, u_int16_t orig_len, u_int8_t
       orig_tos, u_int16_t orig_id, u_int16_t orig_frag, u_int8_t orig_ttl,
       u_int8_t orig_prot, u_int16_t orig_check, u_int32_t orig_src, u_int32_t
       orig_dst, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Message Control Protocol (ICMP)
       redirect header. The additional arguments enable the application
       programmer to easily specify the original IP header values (the IP
       header of the packet that supposedly caused the ICMP redirect message
       in the first place).

       Parameters:
	   type type of ICMP packet (should be ICMP_REDIRECT)
	   code code of ICMP packet (should be one of the four redirect codes)
	   sum checksum (0 for libnet to autofill)
	   orig_id original IP header identification
	   orig_frag original IP header fragmentation information
	   orig_ttl orginal IP header time to live
	   orig_prot original IP header protocol
	   orig_check original IP header checksum
	   orig_src original IP header source address
	   orig_dst original IP header destination address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_timeexceed (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int16_t orig_len, u_int8_t orig_tos, u_int16_t
       orig_id, u_int16_t orig_frag, u_int8_t orig_ttl, u_int8_t orig_prot,
       u_int16_t orig_check, u_int32_t orig_src, u_int32_t orig_dst, u_int8_t
       * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Control Message Protocol (ICMP)
       time exceeded header. The additional arguments enable the application
       programmer to easily specify the original IPv4 header values (the IP
       header of the packet that supposedly caused the ICMP time exceeded
       message in the first place).

       Parameters:
	   type type of ICMP packet (should be ICMP_TIMXCEED)
	   code code of ICMP packet (ICMP_TIMXCEED_INTRANS /
	   ICMP_TIMXCEED_REASS)
	   sum checksum (0 for libnet to autofill)
	   orig_id original IP header identification
	   orig_frag original IP header fragmentation information
	   orig_ttl orginal IP header time to live
	   orig_prot original IP header protocol
	   orig_check original IP header checksum
	   orig_src original IP header source address
	   orig_dst original IP header destination address
	   payload optional payload or NULL
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_timestamp (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int16_t id, u_int16_t seq, n_time otime, n_time rtime,
       n_time ttime, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Control Message Protocol (ICMP)
       timestamp request/reply header.

       Parameters:
	   type type of ICMP packet (should be ICMP_TSTAMP or
	   ICMP_TSTAMPREPLY)
	   code code of ICMP packet (should be 0)
	   sum checksum (0 for libnet to autofill)
	   id identification number
	   seq sequence number
	   otime originate timestamp
	   rtime receive timestamp
	   ttime transmit timestamp
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_icmpv4_unreach (u_int8_t type, u_int8_t code,
       u_int16_t sum, u_int16_t orig_len, u_int8_t orig_tos, u_int16_t
       orig_id, u_int16_t orig_frag, u_int8_t orig_ttl, u_int8_t orig_prot,
       u_int16_t orig_check, u_int32_t orig_src, u_int32_t orig_dst, u_int8_t
       * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an IP version 4 RFC 792 Internet Control Message Protocol (ICMP)
       unreachable header. The additional arguments enable the application
       programmer to easily specify the original IPv4 header values (the IP
       header of the packet that supposedly caused the ICMP unreachable
       message in the first place).

       Parameters:
	   type type of ICMP packet (should be ICMP_UNREACH)
	   code code of ICMP packet (should be one of the 16 unreachable
	   codes)
	   sum checksum (0 for libnet to autofill)
	   orig_id original IP header identification
	   orig_frag original IP header fragmentation information
	   orig_ttl orginal IP header time to live
	   orig_prot original IP header protocol
	   orig_check original IP header checksum
	   orig_src original IP header source address
	   orig_dst original IP header destination address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_igmp (u_int8_t type, u_int8_t code, u_int16_t
       sum, u_int32_t ip, u_int8_t * payload, u_int32_t payload_s, libnet_t *
       l, libnet_ptag_t ptag)
       Builds an RFC 1112 Internet Group Memebership Protocol (IGMP) header.

       Parameters:
	   type packet type
	   code packet code (should be 0)
	   sum checksum (0 for libnet to autofill)
	   ip IPv4 address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipsec_ah (u_int8_t nh, u_int8_t len, u_int16_t
       res, u_int32_t spi, u_int32_t seq, u_int32_t auth, u_int8_t * payload,
       u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an Internet Protocol Security Authentication header.

       Parameters:
	   nh next header
	   len payload length
	   res reserved
	   spi security parameter index
	   seq sequence number
	   auth authentication data
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipsec_esp_ftr (u_int8_t len, u_int8_t nh, int8_t
       * auth, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an Internet Protocol Security Encapsulating Security Payload
       footer.

       Parameters:
	   len padding length
	   nh next header
	   auth authentication data
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipsec_esp_hdr (u_int32_t spi, u_int32_t seq,
       u_int32_t iv, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an Internet Protocol Security Encapsulating Security Payload
       header.

       Parameters:
	   spi security parameter index
	   seq ESP sequence number
	   iv initialization vector
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv4 (u_int16_t len, u_int8_t tos, u_int16_t id,
       u_int16_t frag, u_int8_t ttl, u_int8_t prot, u_int16_t sum, u_int32_t
       src, u_int32_t dst, u_int8_t * payload, u_int32_t payload_s, libnet_t *
       l, libnet_ptag_t ptag)
       Builds a version 4 RFC 791 Internet Protocol (IP) header.

       Parameters:
	   len total length of the IP packet including all subsequent data
	   tos type of service bits
	   id IP identification number
	   frag fragmentation bits and offset
	   ttl time to live in the network
	   prot upper layer protocol
	   sum checksum (0 for libnet to autofill)
	   src source IPv4 address (little endian)
	   dst destination IPv4 address (little endian)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv4_options (u_int8_t * options, u_int32_t
       options_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an version 4 Internet Protocol (IP) options header. The function
       expects options to be a valid IP options string of size options_s, no
       larger than 40 bytes (the maximum size of an options string). The
       function checks to make sure that the preceding header is an IPv4
       header and that the options string would not result in a packet larger
       than 65,535 bytes (IPMAXPACKET). The function counts up the number of
       32-bit words in the options string and adjusts the IP header length
       value as necessary.

       Parameters:
	   options byte string of IP options
	   options_s length of options string
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv6 (u_int8_t tc, u_int32_t fl, u_int16_t len,
       u_int8_t nh, u_int8_t hl, struct libnet_in6_addr src, struct
       libnet_in6_addr dst, u_int8_t * payload, u_int32_t payload_s, libnet_t
       * l, libnet_ptag_t ptag)
       Builds a version 6 RFC 2460 Internet Protocol (IP) header.

       Parameters:
	   tc traffic class
	   fl flow label
	   len total length of the IP packet
	   nh next header
	   hl hop limit
	   src source IPv6 address
	   dst destination IPv6 address
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv6_destopts (u_int8_t nh, u_int8_t len,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Builds a version 6 RFC 2460 Internet Protocol (IP) destination options
       header. This function is special in that it uses the payload interface
       to include the options data. The application programmer will build an
       IPv6 options byte string and pass it to the function using the payload
       interface.

       Parameters:
	   nh next header
	   len length of the header in 8-byte octets not including the first 8
	   octets
	   payload options payload
	   payload_s payload length
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv6_frag (u_int8_t nh, u_int8_t reserved,
       u_int16_t frag, u_int32_t id, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds a version 6 RFC 2460 Internet Protocol (IP) fragmentation
       header.

       Parameters:
	   nh next header
	   reserved unused value... OR IS IT!
	   frag fragmentation bits (ala ipv4)
	   id packet identification
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv6_hbhopts (u_int8_t nh, u_int8_t len,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Builds a version 6 RFC 2460 Internet Protocol (IP) hop by hop options
       header. This function is special in that it uses the payload interface
       to include the options data. The application programmer will build an
       IPv6 hop by hop options byte string and pass it to the function using
       the payload interface.

       Parameters:
	   nh next header
	   len length of the header in 8-byte octets not including the first 8
	   octets
	   payload options payload
	   payload_s payload length
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ipv6_routing (u_int8_t nh, u_int8_t len,
       u_int8_t rtype, u_int8_t segments, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a version 6 RFC 2460 Internet Protocol (IP) routing header. This
       function is special in that it uses the payload interface to include
       the 'type-specific data'; that is the routing information. Most often
       this will be a number of 128-bit IPv6 addresses. The application
       programmer will build a byte string of IPv6 address and pass them to
       the function using the payload interface.

       Parameters:
	   nh next header
	   len length of the header in 8-byte octets not including the first 8
	   octets  routing header type
	   segments number of routing segments that follow
	   payload optional payload of routing information
	   payload_s payload length
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_isl (u_int8_t * dhost, u_int8_t type, u_int8_t
       user, u_int8_t * shost, u_int16_t len, u_int8_t * snap, u_int16_t vid,
       u_int16_t index, u_int16_t reserved, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a Cisco Inter-Switch Link (ISL) header.

       Parameters:
	   dhost destination address (should be 01:00:0c:00:00)
	   type type of frame
	   user user defined data
	   shost source mac address
	   len total length of the encapuslated packet less 18 bytes
	   snap SNAP information (0xaaaa03 + vendor code)
	   vid 15 bit VLAN ID, 1 bit BPDU or CDP indicator
	   index port index
	   reserved used for FDDI and token ring
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_link (u_int8_t * dst, u_int8_t * src, u_int8_t *
       oui, u_int16_t type, u_int8_t * payload, u_int32_t payload_s, libnet_t
       * l, libnet_ptag_t ptag)
       Builds a link layer header for an initialized l. The function
       determines the proper link layer header format from how l was
       initialized. The function current supports Ethernet and Token Ring link
       layers.

       Parameters:
	   dst the destination MAC address
	   src the source MAC address
	   oui Organizationally Unique Identifier (unused for Ethernet)
	   type the upper layer protocol type
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_mpls (u_int32_t label, u_int8_t experimental,
       u_int8_t bos, u_int8_t ttl, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 3032 Multi-Protocol Label Switching (MPLS) header.

       Parameters:
	   label 20-bit label value
	   experimental 3-bit reserved field
	   bos 1-bit bottom of stack identifier
	   ttl time to live
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ntp (u_int8_t leap_indicator, u_int8_t version,
       u_int8_t mode, u_int8_t stratum, u_int8_t poll, u_int8_t precision,
       u_int16_t delay_int, u_int16_t delay_frac, u_int16_t dispersion_int,
       u_int16_t dispersion_frac, u_int32_t reference_id, u_int32_t
       ref_ts_int, u_int32_t ref_ts_frac, u_int32_t orig_ts_int, u_int32_t
       orig_ts_frac, u_int32_t rec_ts_int, u_int32_t rec_ts_frac, u_int32_t
       xmt_ts_int, u_int32_t xmt_ts_frac, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 958 Network Time Protocol (NTP) header.

       Parameters:
	   leap_indicator the leap indicator
	   version NTP protocol version
	   mode NTP mode
	   stratum stratum
	   poll polling interval
	   precision precision
	   delay_interval delay interval
	   delay_frac delay fraction
	   dispersion_int dispersion interval
	   dispersion_frac dispersion fraction
	   reference_id reference id
	   ref_ts_int reference timestamp integer
	   ref_ts_frac reference timestamp fraction
	   orig_ts_int original timestamp integer
	   orig_ts_frac original timestamp fraction
	   rec_ts_int receiver timestamp integer
	   rec_ts_frac reciever timestamp fraction
	   xmt_ts_int transmit timestamp integer
	   xmt_ts_frac transmit timestamp integer
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2 (u_int16_t len, u_int8_t type, u_int32_t
       rtr_id, u_int32_t area_id, u_int16_t sum, u_int16_t autype, u_int8_t *
       payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_dbd (u_int16_t dgram_len, u_int8_t opts,
       u_int8_t type, u_int seqnum, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_hello (u_int32_t netmask, u_int16_t
       interval, u_int8_t opts, u_int8_t priority, u_int dead_int, u_int32_t
       des_rtr, u_int32_t bkup_rtr, u_int32_t neighbor, u_int8_t * payload,
       u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsa (u_int16_t age, u_int8_t opts,
       u_int8_t type, u_int lsid, u_int32_t advrtr, u_int seqnum, u_int16_t
       sum, u_int16_t len, u_int8_t * payload, u_int32_t payload_s, libnet_t *
       l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsa_as (u_int32_t nmask, u_int metric,
       u_int32_t fwdaddr, u_int tag, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsa_net (u_int32_t nmask, u_int rtrid,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsa_rtr (u_int16_t flags, u_int16_t num,
       u_int id, u_int data, u_int8_t type, u_int8_t tos, u_int16_t metric,
       u_int8_t * payload, u_int32_t payload_s, libnet_t * l, libnet_ptag_t
       ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsa_sum (u_int32_t nmask, u_int metric,
       u_int tos, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsr (u_int type, u_int lsid, u_int32_t
       advrtr, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_ospfv2_lsu (u_int num, u_int8_t * payload,
       u_int32_t payload_s, libnet_t * l, libnet_ptag_t ptag)
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_rip (u_int8_t cmd, u_int8_t version, u_int16_t
       rd, u_int16_t af, u_int16_t rt, u_int32_t addr, u_int32_t mask,
       u_int32_t next_hop, u_int32_t metric, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a Routing Information Protocol header (RFCs 1058 and 2453).

       Parameters:
	   cmd command
	   version protocol version
	   rd version one: 0, version two: routing domain
	   af address family
	   rt version one: 0, version two: route tag
	   addr IPv4 address
	   mask version one: 0, version two: subnet mask
	   next_hop version one: 0, version two: next hop address
	   metric routing metric
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_rpc_call (u_int32_t rm, u_int32_t xid, u_int32_t
       prog_num, u_int32_t prog_vers, u_int32_t procedure, u_int32_t cflavor,
       u_int32_t clength, u_int8_t * cdata, u_int32_t vflavor, u_int32_t
       vlength, u_int8_t * vdata, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds an Remote Procedure Call (Version 2) Call message header as
       specified in RFC 1831. This builder provides the option for specifying
       the record marking which is required when used with streaming protocols
       (TCP).

       Parameters:
	   rm record marking indicating the position in a stream, 0 otherwise
	   xid transaction identifier used to link calls and replies
	   prog_num remote program specification typically between 0 -
	   1fffffff
	   prog_vers remote program version specification
	   procedure procedure to be performed by remote program
	   cflavor authentication credential type
	   clength credential length (should be 0)
	   cdata opaque credential data (currently unused)
	   vflavor authentication verifier type
	   vlength verifier length (should be 0)
	   vdata opaque verifier data (currently unused)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_sebek (u_int32_t magic, u_int16_t version,
       u_int16_t type, u_int32_t counter, u_int32_t time_sec, u_int32_t
       time_usec, u_int32_t pid, u_int32_t uid, u_int32_t fd, u_int8_t
       cmd[SEBEK_CMD_LENGTH], u_int32_t length, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a Sebek header. The Sebek protocol was designed by the Honeynet
       Project as a transport mechanism for post-intrusion forensic data. More
       information may be found here:
       http://www.honeynet.org/papers/sebek.pdf.

       Parameters:
	   magic identify packets that should be hidden
	   version protocol version, currently 1
	   type type of record (read data is type 0, write data is type 1)
	   counter PDU counter used to identify when packet are lost
	   time_sec seconds since EPOCH according to the honeypot
	   time_usec residual microseconds
	   pid PID
	   uid UID
	   fd FD
	   cmd[SEBEK_CMD_LENGTH] 12 first characters of the command
	   length length in bytes of the PDU's body
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_stp_conf (u_int16_t id, u_int8_t version,
       u_int8_t bpdu_type, u_int8_t flags, u_int8_t * root_id, u_int32_t
       root_pc, u_int8_t * bridge_id, u_int16_t port_id, u_int16_t
       message_age, u_int16_t max_age, u_int16_t hello_time, u_int16_t
       f_delay, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an IEEE 802.1d Spanning Tree Protocol (STP) configuration
       header. STP frames are usually encapsulated inside of an 802.2 + 802.3
       frame combination.

       Parameters:
	   id protocol id
	   version protocol version
	   bpdu_type bridge protocol data unit type
	   flags flags
	   root_id root id
	   root_pc root path cost
	   bridge_id bridge id
	   port_id port id
	   message_age message age
	   max_age max age
	   hello_time hello time
	   f_delay forward delay
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_stp_tcn (u_int16_t id, u_int8_t version,
       u_int8_t bpdu_type, u_int8_t * payload, u_int32_t payload_s, libnet_t *
       l, libnet_ptag_t ptag)
       Builds an IEEE 802.1d Spanning Tree Protocol (STP) topology change
       notification header. STP frames are usually encapsulated inside of an
       802.2 + 802.3 frame combination.

       Parameters:
	   id protocol id
	   version protocol version
	   bpdu_type bridge protocol data unit type
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_tcp (u_int16_t sp, u_int16_t dp, u_int32_t seq,
       u_int32_t ack, u_int8_t control, u_int16_t win, u_int16_t sum,
       u_int16_t urg, u_int16_t len, u_int8_t * payload, u_int32_t payload_s,
       libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 793 Transmission Control Protocol (TCP) header.

       Parameters:
	   sp source port
	   dp destination port
	   seq sequence number
	   ack acknowledgement number
	   control control flags
	   win window size
	   sum checksum (0 for libnet to autofill)
	   urg urgent pointer  len total length of the TCP packet (for
	   checksum calculation)
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_tcp_options (u_int8_t * options, u_int32_t
       options_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 793 Transmission Control Protocol (TCP) options header.
       The function expects options to be a valid TCP options string of size
       options_s, which is no larger than 40 bytes (the maximum size of an
       options string). The function checks to ensure that the packet consists
       of a TCP header preceded by an IPv4 header, and that the addition of
       the options string would not result in a packet larger than 65,535
       bytes (IPMAXPACKET). The function counts up the number of 32-bit words
       in the options string and adjusts the TCP header length value as
       necessary.

       Parameters:
	   options byte string of TCP options
	   options_s length of options string
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_token_ring (u_int8_t ac, u_int8_t fc, u_int8_t *
       dst, u_int8_t * src, u_int8_t dsap, u_int8_t ssap, u_int8_t cf,
       u_int8_t * org, u_int16_t type, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds a token ring header.

       Parameters:
	   ac access control
	   fc frame control
	   dst destination address
	   src source address
	   dsap destination service access point
	   ssap source service access point
	   cf control field
	   oui Organizationally Unique Identifier
	   type upper layer protocol type
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_udp (u_int16_t sp, u_int16_t dp, u_int16_t len,
       u_int16_t sum, u_int8_t * payload, u_int32_t payload_s, libnet_t * l,
       libnet_ptag_t ptag)
       Builds an RFC 768 User Datagram Protocol (UDP) header.

       Parameters:
	   sp source port
	   dp destination port
	   len total length of the UDP packet
	   sum checksum (0 for libnet to autofill)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   libnet_ptag_t libnet_build_vrrp (u_int8_t version, u_int8_t type, u_int8_t
       vrouter_id, u_int8_t priority, u_int8_t ip_count, u_int8_t auth_type,
       u_int8_t advert_int, u_int16_t sum, u_int8_t * payload, u_int32_t
       payload_s, libnet_t * l, libnet_ptag_t ptag)
       Builds an RFC 2338 Virtual Router Redundacy Protool (VRRP) header. Use
       the payload interface to specify address and autthentication
       information. To build a 'legal' packet, the destination IPv4 address
       should be the multicast * address 224.0.0.18, the IP TTL should be set
       to 255, and the IP protocol should be set to 112.

       Parameters:
	   version VRRP version (should be 2)
	   type VRRP packet type (should be 1 -- ADVERTISEMENT)
	   vrouter_id virtual router identification
	   priority priority (higher numbers indicate higher priority)
	   ip_count number of IPv4 addresses contained in this advertisement
	   auth_type type of authentication (0, 1, 2 -- see RFC)
	   advert_int interval between advertisements
	   sum checksum (0 for libnet to autofill)
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   void libnet_clear_packet (libnet_t * l)
       Clears the current packet referenced and frees all pblocks. Should be
       called when the programmer want to send a completely new packet of a
       different type using the same context.

       Parameters:
	   l pointer to a libnet context

   int libnet_cq_add (libnet_t * l, char * label)
       [Context Queue] Adds a new context to the libnet context queue. If no
       queue exists, this function will create the queue and add the specified
       libnet context as the first entry on the list. The functions checks to
       ensure niether l nor label are NULL, and that label doesn't refer to an
       existing context already in the queue. Additionally, l should refer to
       a libnet context previously initialized with a call to libnet_init().
       If the context queue in write locked, this function will fail.

       Parameters:
	   l pointer to a libnet context
	   label a canonical name given to recognize the new context, no
	   longer than LIBNET_LABEL_SIZE

       Returns:
	   1 on success, -1 on failure

   void libnet_cq_destroy ()
       [Context Queue] Destroys the entire context queue, calling
       libnet_destroy() on each member context.

   libnet_t* libnet_cq_find_by_label (char * label)
       [Context Queue] Locates a libnet context from the queue, indexed by a
       canonical label.

       Parameters:
	   label canonical label of the libnet context to retrieve

       Returns:
	   the expected libnet context, NULL on failure

   int8_t* libnet_cq_getlabel (libnet_t * l)
       [Context Queue] Returns the canonical label associated with the
       context.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   pointer to the libnet context's label

   libnet_t* libnet_cq_head ()
       [Context Queue] Intiailizes the interator interface and set a write
       lock on the entire queue. This function is intended to be called just
       prior to interating through the entire list of contexts (with the
       probable intent of inject a series of packets in rapid succession).
       This function is often used as per the following:

       for (l = libnet_cq_head(); libnet_cq_last(); l = libnet_cq_next()) {
       ... }

       Much of the time, the application programmer will use the iterator as
       it is written above; as such, libnet provides a macro to do exactly
       that, for_each_context_in_cq(l). Warning: do not call the iterator more
       than once in a single loop.

       Returns:
	   the head of the context queue

   int libnet_cq_last ()
       [Context Queue] Check whether the iterator is at the last context in
       the queue.

       Returns:
	   1 if at the end of the context queue, 0 otherwise

   libnet_t* libnet_cq_next ()
       [Context Queue] Get next context from the context queue.	 the next
       context from the context queue

   libnet_t* libnet_cq_remove (libnet_t * l)
       [Context Queue] Removes a specified context from the libnet context
       queue by specifying the libnet context pointer. Note the function will
       remove the specified context from the context queue and cleanup
       internal memory from the queue, it is up to the application programmer
       to free the returned libnet context with a call to libnet_destroy().
       Also, as it is not necessary to keep the libnet context pointer when
       initially adding it to the context queue, most application programmers
       will prefer to refer to entries on the context queue by canonical name
       and would use libnet_cq_remove_by_label(). If the context queue is
       write locked, this function will fail.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   the pointer to the removed libnet context, NULL on failure

   libnet_t* libnet_cq_remove_by_label (char * label)
       [Context Queue] Removes a specified context from the libnet context
       queue by specifying the canonical name. Note the function will remove
       the specified context from the context queue and cleanup internal
       memory from the queue, it is up to the application programmer to free
       the returned libnet context with a call to libnet_destroy(). If the
       context queue is write locked, this function will fail.

       Parameters:
	   label canonical name of the context to remove

       Returns:
	   the pointer to the removed libnet context, NULL on failure

   u_int32_t libnet_cq_size ()
       [Context Queue] Function returns the number of libnet contexts that are
       in the queue.

       Returns:
	   the number of libnet contexts currently in the queue

   void libnet_destroy (libnet_t * l)
       Shuts down the libnet session referenced by l. It closes the network
       interface and frees all internal memory structures associated with l.

       Parameters:
	   l pointer to a libnet context

   void libnet_diag_dump_context (libnet_t * l)
       [Diagnostic] Prints the contents of the given context.

       Parameters:
	   l pointer to a libnet context

   void libnet_diag_dump_hex (u_int8_t * packet, u_int32_t len, int swap, FILE
       * stream)
       [Diagnostic] Function prints the contents of the supplied buffer to the
       supplied stream pointer. Will swap endianness based disposition of mode
       variable. Useful to be used in conjunction with the advanced interface
       and a culled packet.

       Parameters:
	   packet the packet to print
	   len length of the packet in bytes
	   swap 1 to swap byte order, 0 to not
	   stream a stream pointer to print to

   void libnet_diag_dump_pblock (libnet_t * l)
       [Diagnostic] Prints the contents of every pblock.

       Parameters:
	   l pointer to a libnet context

   char* libnet_diag_dump_pblock_type (u_int8_t type)
       [Diagnostic] Returns the canonical name of the pblock type.

       Parameters:
	   type pblock type

       Returns:
	   a string representing the pblock type type or 'unknown' for an
	   unknown value

   struct libnet_ether_addr* libnet_get_hwaddr (libnet_t * l)
       Returns the MAC address for the device libnet was initialized with. If
       libnet was initialized without a device the function will attempt to
       find one. If the function fails and returns NULL a call to
       libnet_geterror() will tell you why.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   a pointer to the MAC address or NULL

   u_int32_t libnet_get_ipaddr4 (libnet_t * l)
       Returns the IP address for the device libnet was initialized with. If
       libnet was initialized without a device (in raw socket mode) the
       function will attempt to find one. If the function fails and returns -1
       a call to libnet_geterrror() will tell you why.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   a big endian IP address suitable for use in a libnet_build function
	   or -1

   struct libnet_in6_addr libnet_get_ipaddr6 (libnet_t * l)
       This function is not yet implemented under IPv6.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   well, nothing yet

   u_int32_t libnet_get_prand (int mod)
       Generates an unsigned psuedo-random value within the range specified by
       mod. LIBNET_PR2 0 - 1 LIBNET_PR8 0 - 255 LIBNET_PR16 0 - 32767
       LIBNET_PRu16 0 - 65535 LIBNET_PR32 0 - 2147483647 LIBNET_PRu32 0 -
       4294967295

       Parameters:
	   mod one the of LIBNET_PR* constants

       Returns:
	   1 on success, -1 on failure

   int8_t* libnet_getdevice (libnet_t * l)
       Returns the canonical name of the device used for packet injection.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   the canonical name of the device used for packet injection. Note it
	   can be NULL without being an error.

   char* libnet_geterror (libnet_t * l)
       Returns the last error set inside of the referenced libnet context.
       This function should be called anytime a function fails or an error
       condition is detected inside of libnet.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   an error string or NULL if no error has occured

   int libnet_getfd (libnet_t * l)
       Returns the FILENO of the file descriptor used for packet injection.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   the file number of the file descriptor used for packet injection

   u_int32_t libnet_getgre_length (u_int16_t fv) [inline]
       Parameters:
	   payload optional payload or NULL
	   payload_s payload length or 0
	   l pointer to a libnet context
	   ptag protocol tag to modify an existing header, 0 to build a new
	   one

       Returns:
	   protocol tag value on success, -1 on error

   u_int32_t libnet_getpacket_size (libnet_t * l)
       Returns the sum of the size of all of the pblocks inside of l (this
       should be the resuling packet size).

       Parameters:
	   l pointer to a libnet context

       Returns:
	   the size of the packet in l

   u_int8_t* libnet_getpbuf (libnet_t * l, libnet_ptag_t ptag)
       Returns the pblock buffer contents for the specified ptag; a subsequent
       call to libnet_getpbuf_size() should be made to determine the size of
       the buffer.

       Parameters:
	   l pointer to a libnet context
	   ptag the ptag reference number

       Returns:
	   a pointer to the pblock buffer or NULL on error

   u_int32_t libnet_getpbuf_size (libnet_t * l, libnet_ptag_t ptag)
       Returns the pblock buffer size for the specified ptag; a previous call
       to libnet_getpbuf() should be made to pull the actual buffer contents.

       Parameters:
	   l pointer to a libnet context
	   ptag the ptag reference number

       Returns:
	   the size of the pblock buffer

   u_int8_t* libnet_hex_aton (int8_t * s, int * len)
       Takes a colon separated hexidecimal address (from the command line) and
       returns a bytestring suitable for use in a libnet_build function. Note
       this function performs an implicit malloc and the return value should
       be freed after its use.

       Parameters:
	   s the string to be parsed
	   len the resulting size of the returned byte string

       Returns:
	   a byte string or NULL on failure

   libnet_t* libnet_init (int injection_type, char * device, char * err_buf)
       Creates the libnet environment. It initializes the library and returns
       a libnet context. If the injection_type is LIBNET_LINK or
       LIBNET_LINK_ADV, the function initializes the injection primitives for
       the link-layer interface enabling the application programmer to build
       packets starting at the data-link layer (which also provides more
       granular control over the IP layer). If libnet uses the link-layer and
       the device argument is non-NULL, the function attempts to use the
       specified network device for packet injection. This is either a
       canonical string that references the device (such as 'eth0' for a 100MB
       Ethernet card on Linux or 'fxp0' for a 100MB Ethernet card on OpenBSD)
       or the dots and decimals representation of the device's IP address
       (192.168.0.1). If device is NULL, libnet attempts to find a suitable
       device to use. If the injection_type is LIBNET_RAW4 or LIBNET_RAW4_ADV,
       the function initializes the injection primitives for the IPv4 raw
       socket interface. The final argument, err_buf, should be a buffer of
       size LIBNET_ERRBUF_SIZE and holds an error message if the function
       fails. This function requires root privileges to execute successfully.
       Upon success, the function returns a valid libnet context for use in
       later function calls; upon failure, the function returns NULL.

       Parameters:
	   injection_type packet injection type (LIBNET_LINK, LIBNET_LINK_ADV,
	   LIBNET_RAW4, LIBNET_RAW4_ADV, LIBNET_RAW6, LIBNET_RAW6_ADV)
	   device the interface to use (NULL and libnet will choose one)
	   err_buf will contain an error message on failure

       Returns:
	   libnet context ready for use or NULL on error.

   u_int32_t libnet_name2addr4 (libnet_t * l, char * host_name, u_int8_t
       use_name)
       Takes a dotted decimal string or a canonical DNS name and returns a
       network byte ordered IPv4 address. This may incur a DNS lookup if mode
       is set to LIBNET_RESOLVE and host_name refers to a canonical DNS name.
       If mode is set to LIBNET_DONT_RESOLVE no DNS lookup will occur. The
       function can fail if DNS lookup fails or if mode is set to
       LIBNET_DONT_RESOLVE and host_name refers to a canonical DNS name.

       Parameters:
	   l pointer to a libnet context
	   host_name pointer to a string containing a presentation format host
	   name
	   use_name LIBNET_RESOLVE or LIBNET_DONT_RESOLVE

       Returns:
	   network byte ordered IPv4 address or -1 (2^32 - 1) on error

   struct libnet_in6_addr libnet_name2addr6 (libnet_t * l, char * host_name,
       u_int8_t use_name)
       Takes a dotted decimal string or a canonical DNS name and returns a
       network byte ordered IPv6 address. This may incur a DNS lookup if mode
       is set to LIBNET_RESOLVE and host_name refers to a canonical DNS name.
       If mode is set to LIBNET_DONT_RESOLVE no DNS lookup will occur. The
       function can fail if DNS lookup fails or if mode is set to
       LIBNET_DONT_RESOLVE and host_name refers to a canonical DNS name.

       Parameters:
	   l pointer to a libnet context
	   host_name pointer to a string containing a presentation format host
	   name
	   use_name LIBNET_RESOLVE or LIBNET_DONT_RESOLVE

       Returns:
	   network byte ordered IPv6 address structure

   int libnet_plist_chain_dump (libnet_plist_t * plist)
       Runs through the port list and prints the contents of the port list
       chain list to stdout.

       Parameters:
	   plist previously created portlist

       Returns:
	   1 on success, -1 on failure

   char* libnet_plist_chain_dump_string (libnet_plist_t * plist)
       Runs through the port list and prints the contents of the port list
       chain list to string. This function uses strdup and is not re-entrant.
       It also has a memory leak and should not really be used.

       Parameters:
	   plist previously created portlist

       Returns:
	   a printable string containing the port list contents on success
	   NULL on error

   int libnet_plist_chain_free (libnet_plist_t * plist)
       Frees all memory associated with port list chain.

       Parameters:
	   plist previously created portlist

       Returns:
	   1 on success, -1 on failure

   int libnet_plist_chain_new (libnet_t * l, libnet_plist_t ** plist, char *
       token_list)
       Creates a new port list. Port list chains are useful for TCP and UDP-
       based applications that need to send packets to a range of ports
       (contiguous or otherwise). The port list chain, which token_list points
       to, should contain a series of int8_tacters from the following list:
       '0123456789,-' of the general format 'x - y, z', where 'xyz' are port
       numbers between 0 and 65,535. plist points to the front of the port
       list chain list for use in further libnet_plist_chain() functions. Upon
       success, the function returns 1. Upon failure, the function returns -1
       and libnet_geterror() can tell you why.

       Parameters:
	   l pointer to a libnet context
	   plist if successful, will refer to the portlist, if not, NULL
	   token_list string containing the port list primitive

       Returns:
	   1 on success, -1 on failure

   int libnet_plist_chain_next_pair (libnet_plist_t * plist, u_int16_t *
       bport, u_int16_t * eport)
       Returns the next port list chain pair from the port list chain plist.
       bport and eport contain the starting port number and ending port
       number, respectively. Upon success, the function returns 1 and fills in
       the port variables; however, if the list is empty, the function returns
       0 and sets both port variables to 0. Upon failure, the function returns
       -1.

       Parameters:
	   plist previously created portlist
	   bport will contain the beginning port number or 0
	   eport will contain the ending port number or 0

       Returns:
	   1 on success, 0 if empty, -1 on failure

   int libnet_seed_prand (libnet_t * l)
       Seeds the psuedo-random number generator.

       Parameters:
	   l pointer to a libnet context

       Returns:
	   1 on success, -1 on failure

   void libnet_stats (libnet_t * l, struct libnet_stats * ls)
       Fills in a libnet_stats structure with packet injection statistics
       (packets written, bytes written, packet sending errors).

       Parameters:
	   l pointer to a libnet context
	   ls pointer to a libnet statistics structure

   int libnet_toggle_checksum (libnet_t * l, libnet_ptag_t ptag, int mode)
       If a given protocol header is built with the checksum field set to '0',
       by default libnet will calculate the header checksum prior to
       injection. If the header is set to any other value, by default libnet
       will not calculate the header checksum. To over-ride this behavior, use
       libnet_toggle_checksum(). Switches auto-checksumming on or off for the
       specified ptag. If mode is set to LIBNET_ON, libnet will mark the
       specificed ptag to calculate a checksum for the ptag prior to
       injection. This assumes that the ptag refers to a protocol that has a
       checksum field. If mode is set to LIBNET_OFF, libnet will clear the
       checksum flag and no checksum will be computed prior to injection. This
       assumes that the programmer will assign a value (zero or otherwise) to
       the checksum field. Often times this is useful if a precomputed
       checksum or some other predefined value is going to be used. Note that
       when libnet is initialized with LIBNET_RAW4, the IPv4 header checksum
       will always be computed by the kernel prior to injection, regardless of
       what the programmer sets.

       Parameters:
	   l pointer to a libnet context
	   ptag the ptag reference number
	   mode LIBNET_ON or LIBNET_OFF

       Returns:
	   1 on success, -1 on failure

   int libnet_write (libnet_t * l)
       Writes a prebuilt packet to the network. The function assumes that l
       was previously initialized (via a call to libnet_init()) and that a
       previously constructed packet has been built inside this context (via
       one or more calls to the libnet_build* family of functions) and is
       ready to go. Depending on how libnet was initialized, the function will
       write the packet to the wire either via the raw or link layer
       interface. The function will also bump up the internal libnet stat
       counters which are retrievable via libnet_stats().

       Parameters:
	   l pointer to a libnet context

       Returns:
	   the number of bytes written, -1 on error

Author
       Generated automatically by Doxygen for libnet from the source code.

libnet				  10 Mar 2004		 libnet-functions.h(3)
[top]

List of man pages available for SuSE

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net