blob: 4e9850f18c3dc5db0b4a50023395a05bea632331 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
#!/bin/bash
# SPDX-License-Identifier: LGPL-2.1
# Copyright (C) 2022, Google Inc, Steven Rostedt <rostedt@goodmis.org>
#
# This checks if any function is listed in a man page that is not listed
# in the main man page.
if [ $# -lt 1 ]; then
echo "usage: check-manpages man-page-path"
exit 1
fi
cd $1
MAIN=libtraceevent
MAIN_FILE=${MAIN}.txt
PROCESSED=""
# Ignore man pages that do not contain functions
IGNORE=""
for man in ${MAIN}-*.txt; do
for a in `sed -ne '/^NAME/,/^SYNOP/{/^[a-z]/{s/, *$//;s/,/\n/g;s/ //g;s/-.*$/-/;/-/{s/-//p;q};p}}' $man`; do
if [ "${PROCESSED/:${a} /}" != "${PROCESSED}" ]; then
P="${PROCESSED/:${a} */}"
echo "Found ${a} in ${man} and in ${P/* /}"
fi
PROCESSED="${man}:${a} ${PROCESSED}"
if [ "${IGNORE/$man/}" != "${IGNORE}" ]; then
continue
fi
if ! grep -q '\*'${a}'\*' $MAIN_FILE; then
if [ "$last" == "" ]; then
echo
fi
if [ "$last" != "$man" ]; then
echo "Missing functions from $MAIN_FILE that are in $man"
last=$man
fi
echo " ${a}"
fi
done
done
DEPRECATED="*tep_print_field*"
# Should not be used by applications, only internal use by trace-cmd
IGNORE="*kbuffer_set_old_format* *kbuffer_raw_get* *kbuffer_ptr_delta* *kbuffer_translate_data*"
HEADER=event-parse.h
sed -ne 's/^[a-z].*[ \*]\([a-z_][a-z_]*\)(.*/\1/p' -e 's/^\([a-z_][a-z_]*\)(.*/\1/p' ../include/traceevent/{event-parse,trace-seq,kbuffer}.h | while read f; do
if ! grep -q '\*'${f}'\*' $MAIN_FILE; then
if [ "${DEPRECATED/\*$f\*/}" != "${DEPRECATED}" ]; then
continue;
fi
if [ "${IGNORE/\*$f\*/}" != "${IGNORE}" ]; then
continue;
fi
for head in event-parse.h trace-seq.h kbuffer.h; do
if grep -q $f ../include/traceevent/$head; then
if [ "$HEADER" != "$head" ]; then
last=""
HEADER=$head
break
fi
fi
done
if [ "$last" == "" ]; then
echo
echo "Missing functions from $MAIN_FILE that are in $HEADER"
last=$f
fi
echo " ${f}"
fi
done
|
