18  * - There are two kinds of sockets: those created by user action (such as
21  * - There are two "global" tables, one for bound sockets (sockets that have
23  * sockets (sockets that have established a connection with another socket).
24  * These tables are "global" in that all sockets on the system are placed
26  * for a list of unbound sockets and SOCK_DGRAM sockets will always remain in
27  * that list. The bound table is used solely for lookup of sockets when packets
28  * are received and that's not necessary for SOCK_DGRAM sockets since we create
30  * sockets out of the bound hash buckets will reduce the chance of collisions
31  * when looking for SOCK_STREAM sockets and prevents us from having to check the
34  * - Sockets created by user action will either be "client" sockets that
35  * initiate a connection or "server" sockets that listen for connections; we do
36  * not support simultaneous connects (two "client" sockets connecting).
38  * - "Server" sockets are referred to as listener sockets throughout this
42  * sockets are placed on the pending connection list of the listener socket.
48  * socket's accept queue.  Callers of accept(2) will accept connected sockets
54  * - It is possible that these pending sockets will never reach the connected
61  * function will also cleanup rejected sockets, those that reach the connected
64  * - Lock ordering for pending or accept queue sockets is:
72  * - Sockets created by user action will be cleaned up when the user process
76  * perform additional cleanup that's common for both types of sockets.
155  * Unbound sockets are all put on the same list attached to the end of the hash
156  * table (vsock_unbound_sockets).  Bound sockets are added to the hash table in
162  * vsock_bind_table[VSOCK_HASH_SIZE - 1] are for bound sockets and
163  * vsock_bind_table[VSOCK_HASH_SIZE] is for unbound sockets.  The hash function
454 		 * just need to drop our references to the sockets and be on  in vsock_pending_work()
461 	/* We need to remove ourself from the global connected sockets list so  in vsock_pending_work()
526 	/* Remove stream sockets from the unbound list and add them to the hash  in __vsock_bind_stream()
600 	 * non-NULL. We make sure that our sockets always have a type by  in __vsock_create()
676 		/* Clean up any sockets that never were accepted. */  in __vsock_release()
862 	/* INET sockets treat local write shutdown and peer write shutdown as a  in vsock_poll()
877 		/* For datagram sockets we can read if there is something in  in vsock_poll()
892 		/* Listening sockets that have connections in their accept  in vsock_poll()
914 		/* Sockets whose connections have been closed, reset, or  in vsock_poll()
923 		/* Connected sockets that can produce data can be written. */  in vsock_poll()
934 						 * sockets are not setting it.  in vsock_poll()
1283 	/* Wait for children sockets to appear; these are the new sockets  in vsock_accept()
1546 	/* Callers should not provide a destination with stream sockets. */  in vsock_stream_sendmsg()
1586 			/* Don't wait for non-blocking sockets. */  in vsock_stream_sendmsg()
1751 			/* Don't wait for non-blocking sockets. */  in vsock_stream_recvmsg()
1946 	 * unload while there are open sockets.  in __vsock_core_init()