text: /*-
   * Copyright (c) 1982, 1986, 1990, 1993
   *	The Regents of the University of California.  All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in the
   *    documentation and/or other materials provided with the distribution.
   * 4. Neither the name of the University nor the names of its contributors
   *    may be used to endorse or promote products derived from this software
   *    without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   *
   *	@(#)in_pcb.h	8.1 (Berkeley) 6/10/93
   * $FreeBSD: src/sys/netinet/in_pcb.h,v 1.100.2.1 2007/12/07 05:46:08 kmacy Exp $
   */
  
  #ifndef _USER_INPCB_H_
  #define _USER_INPCB_H_
  
  #include <user_route.h> /* was <net/route.h> */
  
  struct inpcbpolicy;
  
  /*
   * Struct inpcb is the ommon structure pcb for the Internet Protocol
   * implementation.
   *
   * Pointers to local and foreign host table entries, local and foreign socket
   * numbers, and pointers up (to a socket structure) and down (to a
   * protocol-specific control block) are stored here.
   */
  LIST_HEAD(inpcbhead, inpcb);
  LIST_HEAD(inpcbporthead, inpcbport);
  
  /*
   * PCB with AF_INET6 null bind'ed laddr can receive AF_INET input packet.
   * So, AF_INET6 null laddr is also used as AF_INET null laddr, by utilizing
   * the following structure.
   */
  struct in_addr_4in6 {
  	uint32_t	ia46_pad32[3];
  	struct	in_addr	ia46_addr4;
  };
  
  /*
   * NOTE: ipv6 addrs should be 64-bit aligned, per RFC 2553.  in_conninfo has
   * some extra padding to accomplish this.
   */
  struct in_endpoints {
  	uint16_t	ie_fport;		/* foreign port */
  	uint16_t	ie_lport;		/* local port */
  	/* protocol dependent part, local and foreign addr */
  	union {
  		/* foreign host table entry */
  		struct	in_addr_4in6 ie46_foreign;
  		struct	in6_addr ie6_foreign;
  	} ie_dependfaddr;
  	union {
  		/* local host table entry */
  		struct	in_addr_4in6 ie46_local;
  		struct	in6_addr ie6_local;
  	} ie_dependladdr;
  #define	ie_faddr	ie_dependfaddr.ie46_foreign.ia46_addr4
  #define	ie_laddr	ie_dependladdr.ie46_local.ia46_addr4
  #define	ie6_faddr	ie_dependfaddr.ie6_foreign
  #define	ie6_laddr	ie_dependladdr.ie6_local
  };
  
  /*
   * XXX The defines for inc_* are hacks and should be changed to direct
   * references.
   */
  struct in_conninfo {
  	uint8_t	inc_flags;
  	uint8_t	inc_len;
  	uint16_t	inc_pad;	/* XXX alignment for in_endpoints */
  	/* protocol dependent part */
  	struct	in_endpoints inc_ie;
  };
  #define inc_isipv6	inc_flags	/* temp compatibility */
  #define	inc_fport	inc_ie.ie_fport
  #define	inc_lport	inc_ie.ie_lport
  #define	inc_faddr	inc_ie.ie_faddr
  #define	inc_laddr	inc_ie.ie_laddr
  #define	inc6_faddr	inc_ie.ie6_faddr
  #define	inc6_laddr	inc_ie.ie6_laddr
  
  struct	icmp6_filter;
  
  struct inpcb {
  	LIST_ENTRY(inpcb) inp_hash;	/* hash list */
  	LIST_ENTRY(inpcb) inp_list;	/* list for all PCBs of this proto */
  	void	*inp_ppcb;		/* pointer to per-protocol pcb */
  	struct	inpcbinfo *inp_pcbinfo;	/* PCB list info */
  	struct	socket *inp_socket;	/* back pointer to socket */
  
  	uint32_t	inp_flow;
  	int	inp_flags;		/* generic IP/datagram flags */
  
  	u_char	inp_vflag;		/* IP version flag (v4/v6) */
  #define	INP_IPV4	0x1
  #define	INP_IPV6	0x2
  #define	INP_IPV6PROTO	0x4		/* opened under IPv6 protocol */
  #define	INP_TIMEWAIT	0x8		/* .. probably doesn't go here */
  #define	INP_ONESBCAST	0x10		/* send all-ones broadcast */
  #define	INP_DROPPED	0x20		/* protocol drop flag */
  #define	INP_SOCKREF	0x40		/* strong socket reference */
  #define INP_CONN        0x80
  	u_char	inp_ip_ttl;		/* time to live proto */
  	u_char	inp_ip_p;		/* protocol proto */
  	u_char	inp_ip_minttl;		/* minimum TTL or drop */
  	uint32_t inp_ispare1;		/* connection id / queue id */
  	void	*inp_pspare[2];		/* rtentry / general use */
  
  	/* Local and foreign ports, local and foreign addr. */
  	struct	in_conninfo inp_inc;
  
  					/* list for this PCB's local port */
  	struct	label *inp_label;	/* MAC label */
  	struct	inpcbpolicy *inp_sp;    /* for IPSEC */
  
  	/* Protocol-dependent part; options. */
  	struct {
  		u_char	inp4_ip_tos;		/* type of service proto */
  		struct	mbuf *inp4_options;	/* IP options */
  		struct	ip_moptions *inp4_moptions; /* IP multicast options */
  	} inp_depend4;
  #define	inp_fport	inp_inc.inc_fport
  #define	inp_lport	inp_inc.inc_lport
  #define	inp_faddr	inp_inc.inc_faddr
  #define	inp_laddr	inp_inc.inc_laddr
  #define	inp_ip_tos	inp_depend4.inp4_ip_tos
  #define	inp_options	inp_depend4.inp4_options
  #define	inp_moptions	inp_depend4.inp4_moptions
  	struct {
  		/* IP options */
  		struct	mbuf *inp6_options;
  		/* IP6 options for outgoing packets */
  		struct	ip6_pktopts *inp6_outputopts;
  		/* IP multicast options */
  #if 0
  		struct	ip6_moptions *inp6_moptions;
  #endif
  		/* ICMPv6 code type filter */
  		struct	icmp6_filter *inp6_icmp6filt;
  		/* IPV6_CHECKSUM setsockopt */
  		int	inp6_cksum;
  		short	inp6_hops;
  	} inp_depend6;
  	LIST_ENTRY(inpcb) inp_portlist;
  	struct	inpcbport *inp_phd;	/* head of this list */
  #define inp_zero_size offsetof(struct inpcb, inp_gencnt)
  	struct mtx	inp_mtx;
  
  #define	in6p_faddr	inp_inc.inc6_faddr
  #define	in6p_laddr	inp_inc.inc6_laddr
  #define	in6p_hops	inp_depend6.inp6_hops	/* default hop limit */
  #define	in6p_ip6_nxt	inp_ip_p
  #define	in6p_flowinfo	inp_flow
  #define	in6p_vflag	inp_vflag
  #define	in6p_options	inp_depend6.inp6_options
  #define	in6p_outputopts	inp_depend6.inp6_outputopts
  #if 0
  #define	in6p_moptions	inp_depend6.inp6_moptions
  #endif
  #define	in6p_icmp6filt	inp_depend6.inp6_icmp6filt
  #define	in6p_cksum	inp_depend6.inp6_cksum
  #define	in6p_flags	inp_flags  /* for KAME src sync over BSD*'s */
  #define	in6p_socket	inp_socket  /* for KAME src sync over BSD*'s */
  #define	in6p_lport	inp_lport  /* for KAME src sync over BSD*'s */
  #define	in6p_fport	inp_fport  /* for KAME src sync over BSD*'s */
  #define	in6p_ppcb	inp_ppcb  /* for KAME src sync over BSD*'s */
  };
  /*
   * The range of the generation count, as used in this implementation, is 9e19.
   * We would have to create 300 billion connections per second for this number
   * to roll over in a year.  This seems sufficiently unlikely that we simply
   * don't concern ourselves with that possibility.
   */
  
  struct inpcbport {
  	LIST_ENTRY(inpcbport) phd_hash;
  	struct inpcbhead phd_pcblist;
  	u_short phd_port;
  };
  
  /*
   * Global data structure for each high-level protocol (UDP, TCP, ...) in both
   * IPv4 and IPv6.  Holds inpcb lists and information for managing them.
   */
  struct inpcbinfo {
  	/*
  	 * Global list of inpcbs on the protocol.
  	 */
  	struct inpcbhead	*ipi_listhead;
  	u_int			 ipi_count;
  
  	/*
  	 * Global hash of inpcbs, hashed by local and foreign addresses and
  	 * port numbers.
  	 */
  	struct inpcbhead	*ipi_hashbase;
  	u_long			 ipi_hashmask;
  
  	/*
  	 * Global hash of inpcbs, hashed by only local port number.
  	 */
  	struct inpcbporthead	*ipi_porthashbase;
  	u_long			 ipi_porthashmask;
  
  	/*
  	 * Fields associated with port lookup and allocation.
  	 */
  	u_short			 ipi_lastport;
  	u_short			 ipi_lastlow;
  	u_short			 ipi_lasthi;
  
  	/*
  	 * UMA zone from which inpcbs are allocated for this protocol.
  	 */
  	struct	uma_zone	*ipi_zone;
  
  	/*
  	 * Generation count--incremented each time a connection is allocated
  	 * or freed.
  	 */
  	struct mtx		 ipi_mtx;
  
  	/*
  	 * vimage 1
  	 * general use 1
  	 */
  	void 			*ipi_pspare[2];
  };
  
  #define INP_LOCK_INIT(inp, d, t) \
  	mtx_init(&(inp)->inp_mtx, (d), (t), MTX_DEF | MTX_RECURSE | MTX_DUPOK)
  #define INP_LOCK_DESTROY(inp)	mtx_destroy(&(inp)->inp_mtx)
  #define INP_LOCK(inp)		mtx_lock(&(inp)->inp_mtx)
  #define INP_UNLOCK(inp)		mtx_unlock(&(inp)->inp_mtx)
  #define INP_LOCK_ASSERT(inp)	mtx_assert(&(inp)->inp_mtx, MA_OWNED)
  #define	INP_UNLOCK_ASSERT(inp)	mtx_assert(&(inp)->inp_mtx, MA_NOTOWNED)
  
  #define INP_INFO_LOCK_INIT(ipi, d) \
  	mtx_init(&(ipi)->ipi_mtx, (d), NULL, MTX_DEF | MTX_RECURSE)
  #define INP_INFO_LOCK_DESTROY(ipi)  mtx_destroy(&(ipi)->ipi_mtx)
  #define INP_INFO_RLOCK(ipi)	mtx_lock(&(ipi)->ipi_mtx)
  #define INP_INFO_WLOCK(ipi)	mtx_lock(&(ipi)->ipi_mtx)
  #define INP_INFO_RUNLOCK(ipi)	mtx_unlock(&(ipi)->ipi_mtx)
  #define INP_INFO_WUNLOCK(ipi)	mtx_unlock(&(ipi)->ipi_mtx)
  #define INP_INFO_RLOCK_ASSERT(ipi)	mtx_assert(&(ipi)->ipi_mtx, MA_OWNED)
  #define INP_INFO_WLOCK_ASSERT(ipi)	mtx_assert(&(ipi)->ipi_mtx, MA_OWNED)
  #define INP_INFO_UNLOCK_ASSERT(ipi)	mtx_assert(&(ipi)->ipi_mtx, MA_NOTOWNED)
  
  #define INP_PCBHASH(faddr, lport, fport, mask) \
  	(((faddr) ^ ((faddr) >> 16) ^ ntohs((lport) ^ (fport))) & (mask))
  #define INP_PCBPORTHASH(lport, mask) \
  	(ntohs((lport)) & (mask))
  
  /* flags in inp_flags: */
  #define	INP_RECVOPTS		0x01	/* receive incoming IP options */
  #define	INP_RECVRETOPTS		0x02	/* receive IP options for reply */
  #define	INP_RECVDSTADDR		0x04	/* receive IP dst address */
  #define	INP_HDRINCL		0x08	/* user supplies entire IP header */
  #define	INP_HIGHPORT		0x10	/* user wants "high" port binding */
  #define	INP_LOWPORT		0x20	/* user wants "low" port binding */
  #define	INP_ANONPORT		0x40	/* port chosen for user */
  #define	INP_RECVIF		0x80	/* receive incoming interface */
  #define	INP_MTUDISC		0x100	/* user can do MTU discovery */
  #define	INP_FAITH		0x200	/* accept FAITH'ed connections */
  #define	INP_RECVTTL		0x400	/* receive incoming IP TTL */
  #define	INP_DONTFRAG		0x800	/* don't fragment packet */
  
  #define IN6P_IPV6_V6ONLY	0x008000 /* restrict AF_INET6 socket for v6 */
  
  #define	IN6P_PKTINFO		0x010000 /* receive IP6 dst and I/F */
  #define	IN6P_HOPLIMIT		0x020000 /* receive hoplimit */
  #define	IN6P_HOPOPTS		0x040000 /* receive hop-by-hop options */
  #define	IN6P_DSTOPTS		0x080000 /* receive dst options after rthdr */
  #define	IN6P_RTHDR		0x100000 /* receive routing header */
  #define	IN6P_RTHDRDSTOPTS	0x200000 /* receive dstoptions before rthdr */
  #define	IN6P_TCLASS		0x400000 /* receive traffic class value */
  #define	IN6P_AUTOFLOWLABEL	0x800000 /* attach flowlabel automatically */
  #define	IN6P_RFC2292		0x40000000 /* used RFC2292 API on the socket */
  #define	IN6P_MTU		0x80000000 /* receive path MTU */
  
  #define	INP_CONTROLOPTS		(INP_RECVOPTS|INP_RECVRETOPTS|INP_RECVDSTADDR|\
  				 INP_RECVIF|INP_RECVTTL|\
  				 IN6P_PKTINFO|IN6P_HOPLIMIT|IN6P_HOPOPTS|\
  				 IN6P_DSTOPTS|IN6P_RTHDR|IN6P_RTHDRDSTOPTS|\
  				 IN6P_TCLASS|IN6P_AUTOFLOWLABEL|IN6P_RFC2292|\
  				 IN6P_MTU)
  #define	INP_UNMAPPABLEOPTS	(IN6P_HOPOPTS|IN6P_DSTOPTS|IN6P_RTHDR|\
  				 IN6P_TCLASS|IN6P_AUTOFLOWLABEL)
  
   /* for KAME src sync over BSD*'s */
  #define	IN6P_HIGHPORT		INP_HIGHPORT
  #define	IN6P_LOWPORT		INP_LOWPORT
  #define	IN6P_ANONPORT		INP_ANONPORT
  #define	IN6P_RECVIF		INP_RECVIF
  #define	IN6P_MTUDISC		INP_MTUDISC
  #define	IN6P_FAITH		INP_FAITH
  #define	IN6P_CONTROLOPTS INP_CONTROLOPTS
  	/*
  	 * socket AF version is {newer than,or include}
  	 * actual datagram AF version
  	 */
  
  #define	INPLOOKUP_WILDCARD	1
  #define	sotoinpcb(so)	((struct inpcb *)(so)->so_pcb)
  
  #define	INP_SOCKAF(so) so->so_proto->pr_domain->dom_family
  
  #define	INP_CHECK_SOCKAF(so, af)	(INP_SOCKAF(so) == af)
  
  extern int	ipport_reservedhigh;
  extern int	ipport_reservedlow;
  extern int	ipport_lowfirstauto;
  extern int	ipport_lowlastauto;
  extern int	ipport_firstauto;
  extern int	ipport_lastauto;
  extern int	ipport_hifirstauto;
  extern int	ipport_hilastauto;
  extern struct callout ipport_tick_callout;
  
  void	in_pcbpurgeif0(struct inpcbinfo *, struct ifnet *);
  int	in_pcballoc(struct socket *, struct inpcbinfo *);
  int	in_pcbbind(struct inpcb *, struct sockaddr *, struct ucred *);
  int	in_pcbconnect(struct inpcb *, struct sockaddr *, struct ucred *);
  void	in_pcbdetach(struct inpcb *);
  void	in_pcbdisconnect(struct inpcb *);
  void	in_pcbdrop(struct inpcb *);
  void	in_pcbfree(struct inpcb *);
  int	in_pcbinshash(struct inpcb *);
  struct inpcb *
  	in_pcblookup_local(struct inpcbinfo *,
  	    struct in_addr, u_int, int);
  struct inpcb *
  	in_pcblookup_hash(struct inpcbinfo *, struct in_addr, u_int,
  	    struct in_addr, u_int, int, struct ifnet *);
  void	in_pcbnotifyall(struct inpcbinfo *pcbinfo, struct in_addr,
  	    int, struct inpcb *(*)(struct inpcb *, int));
  void	in_pcbrehash(struct inpcb *);
  void	in_pcbsetsolabel(struct socket *so);
  int	in_getpeeraddr(struct socket *so, struct sockaddr **nam);
  int	in_getsockaddr(struct socket *so, struct sockaddr **nam);
  void	in_pcbsosetlabel(struct socket *so);
  void	in_pcbremlists(struct inpcb *inp);
  void	ipport_tick(void *xtp);
  
  /*
   * Debugging routines compiled in when DDB is present.
   */
  void	db_print_inpcb(struct inpcb *inp, const char *name, int indent);
  
  
  #endif /* !_NETINET_IN_PCB_H_ */
  