centos man page for list_safe_reset_next

LIST_SAFE_RESET_NEXT(9) 					    Data Types						   LIST_SAFE_RESET_NEXT(9)

NAME
       list_safe_reset_next - reset a stale list_for_each_entry_safe loop

SYNOPSIS
       list_safe_reset_next(pos, n, member);

ARGUMENTS
       pos
	   the loop cursor used in the list_for_each_entry_safe loop

       n
	   temporary storage used in list_for_each_entry_safe

       member
	   the name of the list_struct within the struct.

DESCRIPTION
       list_safe_reset_next is not safe to use in general if the list may be modified concurrently (eg. the lock is dropped in the loop body). An
       exception to this is if the cursor element (pos) is pinned in the list, and list_safe_reset_next is called after re-taking the lock and
       before completing the current iteration of the loop body.

COPYRIGHT
Kernel Hackers Manual 3.10					     June 2014						   LIST_SAFE_RESET_NEXT(9)