mirror of
				git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
				synced 2025-10-31 08:44:41 +00:00 
			
		
		
		
	 5fcb7d47fe
			
		
	
	
		5fcb7d47fe
		
	
	
	
	
		
			
			kernel-doc and Sphinx fixes to eliminate lots of warnings in preparation for adding to the networking docbook. ../net/tipc/crypto.c:57: warning: cannot understand function prototype: 'enum ' ../net/tipc/crypto.c:69: warning: cannot understand function prototype: 'enum ' ../net/tipc/crypto.c:130: warning: Function parameter or member 'tfm' not described in 'tipc_tfm' ../net/tipc/crypto.c:130: warning: Function parameter or member 'list' not described in 'tipc_tfm' ../net/tipc/crypto.c:172: warning: Function parameter or member 'stat' not described in 'tipc_crypto_stats' ../net/tipc/crypto.c:232: warning: Function parameter or member 'flags' not described in 'tipc_crypto' ../net/tipc/crypto.c:329: warning: Function parameter or member 'ukey' not described in 'tipc_aead_key_validate' ../net/tipc/crypto.c:329: warning: Function parameter or member 'info' not described in 'tipc_aead_key_validate' ../net/tipc/crypto.c:482: warning: Function parameter or member 'aead' not described in 'tipc_aead_tfm_next' ../net/tipc/trace.c:43: warning: cannot understand function prototype: 'unsigned long sysctl_tipc_sk_filter[5] __read_mostly = ' Documentation/networking/tipc:57: ../net/tipc/msg.c:584: WARNING: Unexpected indentation. Documentation/networking/tipc:63: ../net/tipc/name_table.c:536: WARNING: Unexpected indentation. Documentation/networking/tipc:63: ../net/tipc/name_table.c:537: WARNING: Block quote ends without a blank line; unexpected unindent. Documentation/networking/tipc:78: ../net/tipc/socket.c:3809: WARNING: Unexpected indentation. Documentation/networking/tipc:78: ../net/tipc/socket.c:3807: WARNING: Inline strong start-string without end-string. Documentation/networking/tipc:72: ../net/tipc/node.c:904: WARNING: Unexpected indentation. Documentation/networking/tipc:39: ../net/tipc/crypto.c:97: WARNING: Block quote ends without a blank line; unexpected unindent. Documentation/networking/tipc:39: ../net/tipc/crypto.c:98: WARNING: Block quote ends without a blank line; unexpected unindent. Documentation/networking/tipc:39: ../net/tipc/crypto.c:141: WARNING: Inline strong start-string without end-string. ../net/tipc/discover.c:82: warning: Function parameter or member 'skb' not described in 'tipc_disc_init_msg' ../net/tipc/msg.c:69: warning: Function parameter or member 'gfp' not described in 'tipc_buf_acquire' ../net/tipc/msg.c:382: warning: Function parameter or member 'offset' not described in 'tipc_msg_build' ../net/tipc/msg.c:708: warning: Function parameter or member 'net' not described in 'tipc_msg_lookup_dest' ../net/tipc/subscr.c:65: warning: Function parameter or member 'seq' not described in 'tipc_sub_check_overlap' ../net/tipc/subscr.c:65: warning: Function parameter or member 'found_lower' not described in 'tipc_sub_check_overlap' ../net/tipc/subscr.c:65: warning: Function parameter or member 'found_upper' not described in 'tipc_sub_check_overlap' ../net/tipc/udp_media.c:75: warning: Function parameter or member 'proto' not described in 'udp_media_addr' ../net/tipc/udp_media.c:75: warning: Function parameter or member 'port' not described in 'udp_media_addr' ../net/tipc/udp_media.c:75: warning: Function parameter or member 'ipv4' not described in 'udp_media_addr' ../net/tipc/udp_media.c:75: warning: Function parameter or member 'ipv6' not described in 'udp_media_addr' ../net/tipc/udp_media.c:98: warning: Function parameter or member 'rcast' not described in 'udp_bearer' Also fixed a typo of "duest" to "dest". Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Jakub Kicinski <kuba@kernel.org>
		
			
				
	
	
		
			206 lines
		
	
	
	
		
			7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			206 lines
		
	
	
	
		
			7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /*
 | |
|  * net/tipc/trace.c: TIPC tracepoints code
 | |
|  *
 | |
|  * Copyright (c) 2018, Ericsson AB
 | |
|  * 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.
 | |
|  * 3. Neither the names of the copyright holders nor the names of its
 | |
|  *    contributors may be used to endorse or promote products derived from
 | |
|  *    this software without specific prior written permission.
 | |
|  *
 | |
|  * Alternatively, this software may be distributed under the terms of the
 | |
|  * GNU General Public License ("GPL") version 2 as published by the Free
 | |
|  * Software Foundation.
 | |
|  *
 | |
|  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "ASIS"
 | |
|  * 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 COPYRIGHT OWNER 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.
 | |
|  */
 | |
| 
 | |
| #define CREATE_TRACE_POINTS
 | |
| #include "trace.h"
 | |
| 
 | |
| /*
 | |
|  * socket tuples for filtering in socket traces:
 | |
|  * (portid, sock type, name type, name lower, name upper)
 | |
|  */
 | |
| unsigned long sysctl_tipc_sk_filter[5] __read_mostly = {0, };
 | |
| 
 | |
| /**
 | |
|  * tipc_skb_dump - dump TIPC skb data
 | |
|  * @skb: skb to be dumped
 | |
|  * @more: dump more?
 | |
|  *        - false: dump only tipc msg data
 | |
|  *        - true: dump kernel-related skb data and tipc cb[] array as well
 | |
|  * @buf: returned buffer of dump data in format
 | |
|  */
 | |
| int tipc_skb_dump(struct sk_buff *skb, bool more, char *buf)
 | |
| {
 | |
| 	int i = 0;
 | |
| 	size_t sz = (more) ? SKB_LMAX : SKB_LMIN;
 | |
| 	struct tipc_msg *hdr;
 | |
| 	struct tipc_skb_cb *skbcb;
 | |
| 
 | |
| 	if (!skb) {
 | |
| 		i += scnprintf(buf, sz, "msg: (null)\n");
 | |
| 		return i;
 | |
| 	}
 | |
| 
 | |
| 	hdr = buf_msg(skb);
 | |
| 	skbcb = TIPC_SKB_CB(skb);
 | |
| 
 | |
| 	/* tipc msg data section */
 | |
| 	i += scnprintf(buf, sz, "msg: %u", msg_user(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_type(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_hdr_sz(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_data_sz(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %x", msg_orignode(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %x", msg_destnode(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_seqno(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_ack(hdr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", msg_bcast_ack(hdr));
 | |
| 	switch (msg_user(hdr)) {
 | |
| 	case LINK_PROTOCOL:
 | |
| 		i += scnprintf(buf + i, sz - i, " %c", msg_net_plane(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_probe(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_peer_stopping(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_session(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_next_sent(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_seq_gap(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_bc_snd_nxt(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_bc_gap(hdr));
 | |
| 		break;
 | |
| 	case TIPC_LOW_IMPORTANCE:
 | |
| 	case TIPC_MEDIUM_IMPORTANCE:
 | |
| 	case TIPC_HIGH_IMPORTANCE:
 | |
| 	case TIPC_CRITICAL_IMPORTANCE:
 | |
| 	case CONN_MANAGER:
 | |
| 	case SOCK_WAKEUP:
 | |
| 		i += scnprintf(buf + i, sz - i, " | %u", msg_origport(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_destport(hdr));
 | |
| 		switch (msg_type(hdr)) {
 | |
| 		case TIPC_NAMED_MSG:
 | |
| 			i += scnprintf(buf + i, sz - i, " %u",
 | |
| 				       msg_nametype(hdr));
 | |
| 			i += scnprintf(buf + i, sz - i, " %u",
 | |
| 				       msg_nameinst(hdr));
 | |
| 			break;
 | |
| 		case TIPC_MCAST_MSG:
 | |
| 			i += scnprintf(buf + i, sz - i, " %u",
 | |
| 				       msg_nametype(hdr));
 | |
| 			i += scnprintf(buf + i, sz - i, " %u",
 | |
| 				       msg_namelower(hdr));
 | |
| 			i += scnprintf(buf + i, sz - i, " %u",
 | |
| 				       msg_nameupper(hdr));
 | |
| 			break;
 | |
| 		default:
 | |
| 			break;
 | |
| 		}
 | |
| 		i += scnprintf(buf + i, sz - i, " | %u",
 | |
| 			       msg_src_droppable(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u",
 | |
| 			       msg_dest_droppable(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_errcode(hdr));
 | |
| 		i += scnprintf(buf + i, sz - i, " %u", msg_reroute_cnt(hdr));
 | |
| 		break;
 | |
| 	default:
 | |
| 		/* need more? */
 | |
| 		break;
 | |
| 	}
 | |
| 
 | |
| 	i += scnprintf(buf + i, sz - i, "\n");
 | |
| 	if (!more)
 | |
| 		return i;
 | |
| 
 | |
| 	/* kernel-related skb data section */
 | |
| 	i += scnprintf(buf + i, sz - i, "skb: %s",
 | |
| 		       (skb->dev) ? skb->dev->name : "n/a");
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb->len);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb->data_len);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb->hdr_len);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb->truesize);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb_cloned(skb));
 | |
| 	i += scnprintf(buf + i, sz - i, " %p", skb->sk);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skb_shinfo(skb)->nr_frags);
 | |
| 	i += scnprintf(buf + i, sz - i, " %llx",
 | |
| 		       ktime_to_ms(skb_get_ktime(skb)));
 | |
| 	i += scnprintf(buf + i, sz - i, " %llx\n",
 | |
| 		       ktime_to_ms(skb_hwtstamps(skb)->hwtstamp));
 | |
| 
 | |
| 	/* tipc skb cb[] data section */
 | |
| 	i += scnprintf(buf + i, sz - i, "cb[]: %u", skbcb->bytes_read);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skbcb->orig_member);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u",
 | |
| 		       jiffies_to_msecs(skbcb->nxt_retr));
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skbcb->validated);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u", skbcb->chain_imp);
 | |
| 	i += scnprintf(buf + i, sz - i, " %u\n", skbcb->ackers);
 | |
| 
 | |
| 	return i;
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * tipc_list_dump - dump TIPC skb list/queue
 | |
|  * @list: list of skbs to be dumped
 | |
|  * @more: dump more?
 | |
|  *        - false: dump only the head & tail skbs
 | |
|  *        - true: dump the first & last 5 skbs
 | |
|  * @buf: returned buffer of dump data in format
 | |
|  */
 | |
| int tipc_list_dump(struct sk_buff_head *list, bool more, char *buf)
 | |
| {
 | |
| 	int i = 0;
 | |
| 	size_t sz = (more) ? LIST_LMAX : LIST_LMIN;
 | |
| 	u32 count, len;
 | |
| 	struct sk_buff *hskb, *tskb, *skb, *tmp;
 | |
| 
 | |
| 	if (!list) {
 | |
| 		i += scnprintf(buf, sz, "(null)\n");
 | |
| 		return i;
 | |
| 	}
 | |
| 
 | |
| 	len = skb_queue_len(list);
 | |
| 	i += scnprintf(buf, sz, "len = %d\n", len);
 | |
| 
 | |
| 	if (!len)
 | |
| 		return i;
 | |
| 
 | |
| 	if (!more) {
 | |
| 		hskb = skb_peek(list);
 | |
| 		i += scnprintf(buf + i, sz - i, "  head ");
 | |
| 		i += tipc_skb_dump(hskb, false, buf + i);
 | |
| 		if (len > 1) {
 | |
| 			tskb = skb_peek_tail(list);
 | |
| 			i += scnprintf(buf + i, sz - i, "  tail ");
 | |
| 			i += tipc_skb_dump(tskb, false, buf + i);
 | |
| 		}
 | |
| 	} else {
 | |
| 		count = 0;
 | |
| 		skb_queue_walk_safe(list, skb, tmp) {
 | |
| 			count++;
 | |
| 			if (count == 6)
 | |
| 				i += scnprintf(buf + i, sz - i, "  .\n  .\n");
 | |
| 			if (count > 5 && count <= len - 5)
 | |
| 				continue;
 | |
| 			i += scnprintf(buf + i, sz - i, "  #%d ", count);
 | |
| 			i += tipc_skb_dump(skb, false, buf + i);
 | |
| 		}
 | |
| 	}
 | |
| 	return i;
 | |
| }
 |