251  *				parsed longlink tuple data into.
257  *	processing the CIS.  If a tuple handler returns an error, we
260  *	to allow the caller to distinguish an error from a valid tuple
268  *	to be sure that the tuple count reflects these tuples
274  *	well as any tuple with a link field of CISTPL_END.
282  * To process tuple chains with any long link targets, call this routine
283  *	for each tuple chain you want to process using the list append method
290  *		CW_LONGLINK_MFC_FOUND - if a CISTPL_LONGLINK_MFC tuple
292  *		CW_LONGLINK_A_FOUND - if a CISTPL_LONGLINK_A tuple was
294  *		CW_LONGLINK_C_FOUND - if a CISTPL_LONGLINK_C tuple was
298  *	tuple is seen, the *cisparse argument will return an appropriate
310  * For each tuple that we see, the following flags in the tuple_t->flags member
313  *		CISTPLF_COPYOK - OK to copy tuple data
314  *		CISTPLF_GLOBAL_CIS - tuple from global CIS
315  *		CISTPLF_MF_CIS - tuple from MF CIS chain
316  *		CISTPLF_FROM_AM - tuple read from AM space
317  *		CISTPLF_FROM_CM - tuple read from CM space
318  *		CISTPLF_LINK_INVALID - tuple link is invalid
319  *		CISTPLF_PARAMS_INVALID - tuple body is invalid
320  *		CISTPLF_AM_SPACE - this tuple is in AM space
321  *		CISTPLF_CM_SPACE - this tuple is in CM space
322  *		CISTPLF_LM_SPACE - this tuple is in local memory
352 	 * If this is primary CIS chain, the first tuple must be one  in cis_list_lcreate()
397 	 * The main tuple processing loop.  We'll exit this loop when either  in cis_list_lcreate()
398 	 *	a tuple's link field is CISTPL_END or we've seen a tuple type  in cis_list_lcreate()
402 	 *	include them in the tuple count that we return.  in cis_list_lcreate()
420 			 * point to tuple link field and get the link value  in cis_list_lcreate()
428 		 *	last tuple.  The problem is that this tuple might  in cis_list_lcreate()
434 		 *	that when we're done processing this tuple, we will  in cis_list_lcreate()
443 		 * point to first byte of tuple data, allocate a new list  in cis_list_lcreate()
472 			 * Save the address in CIS space that this tuple  in cis_list_lcreate()
473 			 *	begins at, as well as set tuple flags.  in cis_list_lcreate()
478 			 * If this tuple has tuple data, we might need to  in cis_list_lcreate()
480 			 * Note that the tuple data pointer (tp->data) will  in cis_list_lcreate()
481 			 *	be set to NULL for a tuple with no data.  in cis_list_lcreate()
487 			 * Read the data in the tuple and store it  in cis_list_lcreate()
491 			 *	of the tuple.  in cis_list_lcreate()
500 			 * We first give the tuple handler a chance  in cis_list_lcreate()
501 			 *	to set any tuple flags that it wants  in cis_list_lcreate()
503 			 *	copy, and give the tuple handler another  in cis_list_lcreate()
504 			 *	shot at the tuple.  in cis_list_lcreate()
519 				 *	the tuple data, allocate space for it,  in cis_list_lcreate()
521 				 *	starting address of this tuple.  in cis_list_lcreate()
539 				 * If we made a local copy of the tuple data,  in cis_list_lcreate()
541 				 *	tuple data is still on the card, then  in cis_list_lcreate()
550 			 * This is a tuple with no data in it's body, so  in cis_list_lcreate()
566 			 *	tuple.  in cis_list_lcreate()
580 			 * Check to see if this is a longlink tuple and if  in cis_list_lcreate()
593 			 *	the beginning of the next tuple.  in cis_list_lcreate()
613  *	This function examines the passed-in tuple type and if it is a
614  *	longlink tuple, the tuple is parsed and the appropriate flags in
617  *	If there is an error parsing the tuple, HANDTPL_ERROR is returned
626 	 *	or CISTPL_LONGLINK_MFC tuple, parse the tuple  in cis_process_longlink()
628 	 * If this is a CISTPL_NO_LINK tuple, or if there is an  in cis_process_longlink()
629 	 *	error parsing the tuple, clear all the  in cis_process_longlink()
663  * cis_list_ldestroy - function to destroy a linked tuple list
697 		 * Free this tuple  in cis_list_ldestroy()
718  *			a tuple based on various criteria
720  *	cistpl_t *tp - pointer to any valid tuple in the list
721  *	cisdata_t type - type of tuple to search for
724  *		    Returns the {first|last} tuple in the list.
727  *		    Returns the first tuple that matches the passed tuple type,
730  *		    Returns the {next|previous} tuple in the list.
738  *	the search starts at the passed tuple.  Continually calling this
739  *	function with a tuple that is the same type as the passed type will
740  *	continually return the same tuple.
743  *	the search starts at the {next|previous} tuple from the passed tuple.
746  *	cistpl_t * - pointer to tuple in list
747  *	NULL - if error while processing list or tuple not found
760 	    case GET_FIRST_LTUPLEF:	/* return first tuple in list */  in cis_get_ltuple()
769 	    case GET_LAST_LTUPLEF:	/* return last tuple in list */  in cis_get_ltuple()
778 	    case FIND_LTUPLE_FWDF:	/* find tuple, fwd search from tp */  in cis_get_ltuple()
787 		/* find tuple, backward search from tp */  in cis_get_ltuple()
795 	    case FIND_NEXT_LTUPLEF:	/* find tuple, fwd search from tp+1 */  in cis_get_ltuple()
804 		/* find tuple, backward search from tp-1 */  in cis_get_ltuple()
812 	    case GET_NEXT_LTUPLEF:	/* return next tuple in list */  in cis_get_ltuple()
819 	    case GET_PREV_LTUPLEF:	/* return prev tuple in list */  in cis_get_ltuple()
966  *				the CISTPL_LONGLINK_MFC tuple
1002 	 *	that there is a CISTPL_LONGLINK_C tuple that points to  in cis_list_create()
1005 	 *	so that we'll check for a valid first tuple.  in cis_list_create()
1058 	 *	tuple. We need to save that information and then process  in cis_list_create()
1070 	 *	CISTPL_LINKTARGET tuple. Also set CW_RET_ON_LINKTARGET_ERROR  in cis_list_create()
1072 	 *	tuple is invalid or missing.  in cis_list_create()
1111 		 *	in the global CIS.  If the tuple exists  in cis_list_create()
1114 		 *	we flag the tuple  in cis_list_create()
1145  *	CISTPL_LONGLINK_MFC tuple, we return - the caller is responsible
1160  *			parsed tuple data will be returned
1162  * To check the CISTPL_LINKTARGET tuple at the beginning of the first
1176  * Note that if the first tuple of the target CIS chain is supposed
1178  *	contain that tuple (or that tuple is invalid in some way) and
1183  * To return an error if an invalid CISTPL_LINKTARGET tuple is seen,
1202 		 *	is the target of a longlink tuple,  in cis_create_cis_chain()
1205 		 *	CISTPL_LINKTARGET tuple is invalid,  in cis_create_cis_chain()
1252 		 *	tuple, then by now we have already validated  in cis_create_cis_chain()
1253 		 *	the CISTPL_LINKTARGET tuple so that we  in cis_create_cis_chain()
1254 		 *	know we'll have at least one tuple in  in cis_create_cis_chain()
1283 			 * Point to the last tuple in the list.  in cis_create_cis_chain()
1296 			 * Point to the last tuple in the list.  in cis_create_cis_chain()
1311 	 *	we saw a longlink tuple, restore the list head pointer now.  in cis_create_cis_chain()
1348  *	of the beginning of the tuple into the passed linked list element.
1351  *	to the tuple type byte.
1356  *		CISTPLF_GLOBAL_CIS - tuple in global CIS
1357  *		CISTPLF_MF_CIS - tuple in function-specific CIS