mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-26 10:49:33 +00:00
![Randy Dunlap](/assets/img/avatar_default.png)
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;
|
|
}
|