d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

ipfilter bug #558 add in some missing frag table function comments.

Browse Source 
Approved by:	glebius (mentor)
Obtained from:	ipfilter CVS repo (r1.36)
This commit is contained in:
Cy Schubert 2014-09-24 01:21:31 +00:00
parent 1dee8327d4
commit f88ccb8bee
1 changed files with 33 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
sys/contrib/ipfilter/netinet/ip_frag.c
View File

@ -930,7 +930,8 @@ ipf_frag_known(fin, passp)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_natforget */ /* Function: ipf_frag_natforget */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: ptr(I) - pointer to data structure */ /* Parameters: softc(I) - pointer to soft context main structure */
/* ptr(I) - pointer to data structure */
/* */ /* */
/* Search through all of the fragment cache entries for NAT and wherever a */ /* Search through all of the fragment cache entries for NAT and wherever a */
/* pointer is found to match ptr, reset it to NULL. */ /* pointer is found to match ptr, reset it to NULL. */
@ -954,7 +955,8 @@ ipf_frag_natforget(softc, ptr)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_delete */ /* Function: ipf_frag_delete */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: fra(I) - pointer to fragment structure to delete */ /* Parameters: softc(I) - pointer to soft context main structure */
/* fra(I) - pointer to fragment structure to delete */
/* tail(IO) - pointer to the pointer to the tail of the frag */ /* tail(IO) - pointer to the pointer to the tail of the frag */
/* list */ /* list */
/* */ /* */
@ -991,7 +993,10 @@ ipf_frag_delete(softc, fra, tail)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_free */ /* Function: ipf_frag_free */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: softf(I) - pointer to fragment context information */
/* fra(I) - pointer to fragment structure to free */
/* */ /* */
/* Free up a fragment cache entry and bump relevent statistics. */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
static void static void
ipf_frag_free(softf, fra) ipf_frag_free(softf, fra)
@ -1007,7 +1012,7 @@ ipf_frag_free(softf, fra)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_clear */ /* Function: ipf_frag_clear */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: Nil */ /* Parameters: softc(I) - pointer to soft context main structure */
/* */ /* */
/* Free memory in use by fragment state information kept. Do the normal */ /* Free memory in use by fragment state information kept. Do the normal */
/* fragment state stuff first and then the NAT-fragment table. */ /* fragment state stuff first and then the NAT-fragment table. */
@ -1048,7 +1053,7 @@ ipf_frag_clear(softc)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_expire */ /* Function: ipf_frag_expire */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: Nil */ /* Parameters: softc(I) - pointer to soft context main structure */
/* */ /* */
/* Expire entries in the fragment cache table that have been there too long */ /* Expire entries in the fragment cache table that have been there too long */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
@ -1120,6 +1125,13 @@ ipf_frag_expire(softc)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_pkt_next */ /* Function: ipf_frag_pkt_next */
/* Returns: int - 0 == success, else error */
/* Parameters: softc(I) - pointer to soft context main structure */
/* token(I) - pointer to token information for this caller */
/* itp(I) - pointer to generic iterator from caller */
/* */
/* This function is used to step through the fragment cache list used for */
/* filter rules. The hard work is done by the more generic ipf_frag_next. */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
int int
ipf_frag_pkt_next(softc, token, itp) ipf_frag_pkt_next(softc, token, itp)
@ -1140,6 +1152,13 @@ ipf_frag_pkt_next(softc, token, itp)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_nat_next */ /* Function: ipf_frag_nat_next */
/* Returns: int - 0 == success, else error */
/* Parameters: softc(I) - pointer to soft context main structure */
/* token(I) - pointer to token information for this caller */
/* itp(I) - pointer to generic iterator from caller */
/* */
/* This function is used to step through the fragment cache list used for */
/* NAT. The hard work is done by the more generic ipf_frag_next. */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
int int
ipf_frag_nat_next(softc, token, itp) ipf_frag_nat_next(softc, token, itp)
@ -1160,7 +1179,8 @@ ipf_frag_nat_next(softc, token, itp)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_next */ /* Function: ipf_frag_next */
/* Returns: int - 0 == success, else error */ /* Returns: int - 0 == success, else error */
/* Parameters: token(I) - pointer to token information for this caller */ /* Parameters: softc(I) - pointer to soft context main structure */
/* token(I) - pointer to token information for this caller */
/* itp(I) - pointer to generic iterator from caller */ /* itp(I) - pointer to generic iterator from caller */
/* top(I) - top of the fragment list */ /* top(I) - top of the fragment list */
/* lock(I) - fragment cache lock */ /* lock(I) - fragment cache lock */
@ -1239,7 +1259,11 @@ ipf_frag_next(softc, token, itp, top
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_pkt_deref */ /* Function: ipf_frag_pkt_deref */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: softc(I) - pointer to soft context main structure */
/* data(I) - pointer to frag cache pointer */
/* */ /* */
/* This function is the external interface for dropping a reference to a */
/* fragment cache entry used by filter rules. */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
void void
ipf_frag_pkt_deref(softc, data) ipf_frag_pkt_deref(softc, data)
@ -1261,7 +1285,11 @@ ipf_frag_pkt_deref(softc, data)
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
/* Function: ipf_frag_nat_deref */ /* Function: ipf_frag_nat_deref */
/* Returns: Nil */ /* Returns: Nil */
/* Parameters: softc(I) - pointer to soft context main structure */
/* data(I) - pointer to frag cache pointer */
/* */ /* */
/* This function is the external interface for dropping a reference to a */
/* fragment cache entry used by NAT table entries. */
/* ------------------------------------------------------------------------ */ /* ------------------------------------------------------------------------ */
void void
ipf_frag_nat_deref(softc, data) ipf_frag_nat_deref(softc, data)