summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2021-11-05 04:46:29 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2021-11-05 04:46:29 +0000
commitc845a4b8dd0f426919ec72fa22ae296e1e262dcc (patch)
tree374a0df62a4711399a4b0c5f014ea90f8fba15c6
parentAdding upstream version 1.0.0. (diff)
downloadlibopencsd-c845a4b8dd0f426919ec72fa22ae296e1e262dcc.tar.xz
libopencsd-c845a4b8dd0f426919ec72fa22ae296e1e262dcc.zip
Adding debian version 1.0.0-1.debian/1.0.0-1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
-rw-r--r--debian/changelog105
-rw-r--r--debian/control63
-rw-r--r--debian/copyright42
-rw-r--r--debian/libopencsd-bin.install1
-rw-r--r--debian/libopencsd-bin.manpages1
-rw-r--r--debian/libopencsd-dev.dirs2
-rw-r--r--debian/libopencsd-dev.install4
-rw-r--r--debian/libopencsd-doc.doc-base8
-rw-r--r--debian/libopencsd-doc.docs5
-rw-r--r--debian/libopencsd.pc.in12
-rw-r--r--debian/libopencsd1.dirs1
-rw-r--r--debian/libopencsd1.install1
-rw-r--r--debian/outfile1
-rw-r--r--debian/patches/series0
-rwxr-xr-xdebian/rules60
-rw-r--r--debian/source/format1
-rw-r--r--debian/source/options2
-rw-r--r--debian/source/patch-header18
-rw-r--r--debian/trc_pkt_lister.1122
-rw-r--r--debian/watch10
20 files changed, 459 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..6bdf62d
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,105 @@
+libopencsd (1.0.0-1) experimental; urgency=medium
+
+ * New upstream release.
+
+ -- Wookey <wookey@debian.org> Sat, 09 Jan 2021 01:03:07 +0000
+
+libopencsd (0.14.4-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Sat, 21 Nov 2020 02:41:15 +0000
+
+libopencsd (0.14.3-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Tue, 29 Sep 2020 02:40:21 +0100
+
+libopencsd (0.14.1-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Tue, 05 May 2020 17:02:54 +0100
+
+libopencsd (0.14.0-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Mon, 30 Mar 2020 13:02:06 +0100
+
+libopencsd (0.12.2-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Mon, 10 Feb 2020 22:37:53 +0000
+
+libopencsd (0.12.1-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Tue, 29 Oct 2019 21:00:33 +0000
+
+libopencsd (0.12.0-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Wed, 31 Jul 2019 21:24:01 +0100
+
+libopencsd (0.11.2-1) experimental; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Thu, 30 May 2019 22:35:21 +0100
+
+libopencsd (0.11.1-1) experimental; urgency=medium
+
+ * New upstream release
+ * Uses -fPIC instead of -fpic to allow sparc64 to build.
+
+ -- Wookey <wookey@debian.org> Sat, 16 Mar 2019 02:05:54 +0000
+
+libopencsd (0.10.1-1) unstable; urgency=medium
+
+ * New upstream release, no functional changes
+
+ -- Wookey <wookey@debian.org> Fri, 30 Nov 2018 19:19:07 +0000
+
+libopencsd (0.10.0-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Fri, 26 Oct 2018 21:56:06 +0100
+
+libopencsd (0.9.3-2) unstable; urgency=medium
+
+ * Fix typo in output
+ * Update standards
+ * Ensure hardening flags
+
+ -- Wookey <wookey@debian.org> Fri, 12 Oct 2018 15:52:06 +0100
+
+libopencsd (0.9.3-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Tue, 09 Oct 2018 02:03:59 +0100
+
+libopencsd (0.9.1-1) unstable; urgency=medium
+
+ * New upstream release
+
+ -- Wookey <wookey@debian.org> Fri, 27 Jul 2018 17:31:23 +0100
+
+libopencsd (0.9.0-1) unstable; urgency=medium
+
+ * New upstream release (Closes: #901953)
+ * All debian patches incorporated upstream
+
+ -- Wookey <wookey@debian.org> Thu, 21 Jun 2018 13:16:23 +0100
+
+libopencsd (0.8.1-1) unstable; urgency=medium
+
+ * Initial release (Closes: #891955)
+
+ -- Wookey <wookey@debian.org> Sat, 17 Mar 2018 03:17:30 +0000
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..1018afd
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,63 @@
+Source: libopencsd
+Priority: optional
+Maintainer: Wookey <wookey@debian.org>
+Build-Depends: debhelper-compat (= 12), doxygen, graphviz, jdupes
+Standards-Version: 4.5.0
+Section: libs
+Homepage: https://github.com/Linaro/OpenCSD
+Rules-Requires-Root: no
+Vcs-Browser: https://salsa.debian.org/wookey/libopencsd
+Vcs-Git: https://salsa.debian.org/wookey/libopencsd.git
+
+Package: libopencsd-dev
+Section: libdevel
+Architecture: any
+Multi-Arch: same
+Depends: libopencsd1 (= ${binary:Version}), ${misc:Depends}
+Description: ARM CoreSight trace decode library development files
+ This library provides an API suitable for the decode of ARM(r) CoreSight(tm)
+ trace streams. It supports ETMv3 data & instruction trace, ETMv4 instruction
+ trace, PTM (v1.1) instruction trace, STM (v1.1) software trace, and support for
+ external/custom decoders.
+ .
+ This is the development package containing the headers and static library build
+
+Package: libopencsd1
+Architecture: any
+Multi-Arch: same
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: ARM CoreSight Trace decode library
+ This library provides an API suitable for the decode of ARM(r) CoreSight(tm)
+ trace streams. It supports ETMv3 data & instruction trace, ETMv4 instruction
+ trace, PTM (v1.1) instruction trace, STM (v1.1) software trace, and support for
+ external/custom decoders.
+ .
+ This library is trypically used via perf, but libopencsd-bin also contains a
+ test binary.
+
+Package: libopencsd-bin
+Section: libdevel
+Architecture: any
+Multi-Arch: foreign
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: ARM CoreSight trace decode utility
+ Tool to decode ARM Coresight trace stream packets.
+ .
+ The CoreSight library provides an API suitable for the decode of ARM(r)
+ CoreSight(tm) trace streams. It supports ETMv3 data & instruction trace,
+ ETMv4 instruction trace, PTM (v1.1) instruction trace, STM (v1.1) software
+ trace, and support for external/custom decoders.
+ .
+ This is the tools package containing useful binaries.
+
+Package: libopencsd-doc
+Section: doc
+Architecture: all
+Depends: ${misc:Depends}
+Description: ARM CoreSight trace decode library documentation
+ This library provides an API suitable for the decode of ARM(r) CoreSight(tm)
+ trace streams. It supports ETMv3 data & instruction trace, ETMv4 instruction
+ trace, PTM (v1.1) instruction trace, STM (v1.1) software trace, and support for
+ external/custom decoders.
+ .
+ This is the documentation package.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..5bcf3bd
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,42 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: OpenCSD
+Upstream-Contact: coresight@lists.linaro.org
+Source: https://github.com/Linaro/OpenCSD
+
+Files: *
+Copyright: 2015-2018 ARM Limited
+License: BSD-3-clause
+
+Files: debian/*
+Copyright: 2018 Wookey <wookey@debian.org>
+License: BSD-3-clause
+
+License: BSD-3-clause
+ Copyright (c) 2015, ARM Limited. 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 name of the copyright holder nor the names of its contributors
+ may be used to endorse or promote products derived from this software without
+ specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' 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 HOLDER 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.
+
+
diff --git a/debian/libopencsd-bin.install b/debian/libopencsd-bin.install
new file mode 100644
index 0000000..4c1c02f
--- /dev/null
+++ b/debian/libopencsd-bin.install
@@ -0,0 +1 @@
+usr/bin/trc_pkt_lister
diff --git a/debian/libopencsd-bin.manpages b/debian/libopencsd-bin.manpages
new file mode 100644
index 0000000..f2cae4a
--- /dev/null
+++ b/debian/libopencsd-bin.manpages
@@ -0,0 +1 @@
+debian/trc_pkt_lister.1
diff --git a/debian/libopencsd-dev.dirs b/debian/libopencsd-dev.dirs
new file mode 100644
index 0000000..4418816
--- /dev/null
+++ b/debian/libopencsd-dev.dirs
@@ -0,0 +1,2 @@
+usr/lib
+usr/include
diff --git a/debian/libopencsd-dev.install b/debian/libopencsd-dev.install
new file mode 100644
index 0000000..ce24a29
--- /dev/null
+++ b/debian/libopencsd-dev.install
@@ -0,0 +1,4 @@
+usr/include/*
+usr/lib/*/lib*.a
+usr/lib/*/pkgconfig/*
+usr/lib/*/libopencsd*.so
diff --git a/debian/libopencsd-doc.doc-base b/debian/libopencsd-doc.doc-base
new file mode 100644
index 0000000..0f12189
--- /dev/null
+++ b/debian/libopencsd-doc.doc-base
@@ -0,0 +1,8 @@
+Document: libopencsd
+Title: libOpenCSD Manual
+Abstract: This manual describes libopencsd, usage and classes
+Section: System/Monitoring
+
+Format: HTML
+Index: /usr/share/doc/libopencsd-dev/html/index.html
+Files: /usr/share/doc/libopencsd-dev/html/*.html
diff --git a/debian/libopencsd-doc.docs b/debian/libopencsd-doc.docs
new file mode 100644
index 0000000..0973d7d
--- /dev/null
+++ b/debian/libopencsd-doc.docs
@@ -0,0 +1,5 @@
+HOWTO.md
+README.md
+decoder/docs/*.md
+decoder/docs/specs/
+decoder/docs/html \ No newline at end of file
diff --git a/debian/libopencsd.pc.in b/debian/libopencsd.pc.in
new file mode 100644
index 0000000..f9627b6
--- /dev/null
+++ b/debian/libopencsd.pc.in
@@ -0,0 +1,12 @@
+prefix=@PREFIX@
+exec_prefix=${prefix}
+libdir=${prefix}/@LIB_PATH@
+includedir=${prefix}/include
+
+Name: libopencsd
+Description: ARM trace decode library
+Version: 0.0
+
+Requires:
+Libs: -L${libdir} -lopencsd
+Cflags: -I${includedir}
diff --git a/debian/libopencsd1.dirs b/debian/libopencsd1.dirs
new file mode 100644
index 0000000..6845771
--- /dev/null
+++ b/debian/libopencsd1.dirs
@@ -0,0 +1 @@
+usr/lib
diff --git a/debian/libopencsd1.install b/debian/libopencsd1.install
new file mode 100644
index 0000000..165056c
--- /dev/null
+++ b/debian/libopencsd1.install
@@ -0,0 +1 @@
+usr/lib/*/libopencsd*.so.*
diff --git a/debian/outfile b/debian/outfile
new file mode 100644
index 0000000..163aaf8
--- /dev/null
+++ b/debian/outfile
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/debian/patches/series b/debian/patches/series
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/debian/patches/series
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..1451f0f
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,60 @@
+#!/usr/bin/make -f
+# See debhelper(7) (uncomment to enable)
+# output every command that modifies files on the build system.
+export DH_VERBOSE = 1
+
+DPKG_EXPORT_BUILDFLAGS = 1
+include /usr/share/dpkg/default.mk
+include /usr/share/dpkg/architecture.mk
+
+PREFIX=/usr
+LIB_PATH=lib/$(DEB_HOST_MULTIARCH)
+PKG_VERSION=$(shell dpkg-parsechangelog -S version | cut -d- -f1)
+export CROSS_COMPILE=$(DEB_HOST_GNU_TYPE)-
+
+ifneq (,$(filter noopt,$(DEB_BUILD_OPTIONS)))
+ OPTS="DEBUG=1"
+endif
+
+# see ENVIRONMENT in dpkg-buildflags(1)
+export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
+export DEB_BUILD_MAINT_OPTIONS += hardening=+all
+
+%:
+ dh $@
+
+
+override_dh_auto_build-arch:
+ make -f decoder/build/linux/makefile $(OPTS) LIB_PATH=$(LIB_PATH)
+#always build tests as one util is useful
+#await mechanism for running build-time tests.
+#ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
+# make -f decoder/build/linux/makefile tests $(OPT_PATH=$(LIB_PATH)
+#endif
+ sed -r -e 's/^(Version: ).*$$/\1$(PKG_VERSION)/' debian/libopencsd.pc.in > debian/libopencsd.pc
+ sed -i -e 's:@PREFIX@:$(PREFIX):' debian/libopencsd.pc
+ sed -i -e 's:@LIB_PATH@:$(LIB_PATH):' debian/libopencsd.pc
+
+override_dh_auto_build-indep:
+ifeq (,$(filter nodoc,$(DEB_BUILD_OPTIONS)))
+ make -f decoder/build/linux/makefile docs
+endif
+
+override_dh_installdocs:
+ # kick compat 11+ to put docs where we told it
+ dh_installdocs -X.md5 -X.map
+ jdupes -rl debian/libopencsd-doc/usr/share/doc/
+
+override_dh_compress:
+ dh_compress -X.pdf
+
+override_dh_auto_install-arch:
+ make -f decoder/build/linux/makefile install PREFIX=$(CURDIR)/debian/tmp/usr $(OPTS) LIB_PATH=$(LIB_PATH)
+ mkdir -p debian/tmp/usr/$(LIB_PATH)/pkgconfig/
+ cp debian/libopencsd.pc debian/tmp/usr/$(LIB_PATH)/pkgconfig/
+
+override_dh_clean:
+ make -f decoder/build/linux/makefile clean $(OPTS) LIB_PATH=$(LIB_PATH)
+ -rm -r decoder/lib decoder/tests/bin
+ -rm debian/libopencsd.pc
+ dh_clean
diff --git a/debian/source/format b/debian/source/format
new file mode 100644
index 0000000..163aaf8
--- /dev/null
+++ b/debian/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/debian/source/options b/debian/source/options
new file mode 100644
index 0000000..ce071fb
--- /dev/null
+++ b/debian/source/options
@@ -0,0 +1,2 @@
+single-debian-patch
+auto-commit
diff --git a/debian/source/patch-header b/debian/source/patch-header
new file mode 100644
index 0000000..5bed5d4
--- /dev/null
+++ b/debian/source/patch-header
@@ -0,0 +1,18 @@
+The Debian packaging of foo is maintained in git, using the merging
+workflow described in dgit-maint-merge(7). There isn't a patch
+queue that can be represented as a quilt series.
+
+A detailed breakdown of the changes is available from their
+canonical representation - git commits in the packaging repository.
+For example, to see the changes made by the Debian maintainer in
+the first upload of upstream version 0.14.1, (when this package first
+used dgit) you could use:
+
+ % git clone https://git.dgit.debian.org/libopencsd
+ % cd libopencsd
+ % git log --oneline 0.14.1..debian/0.14.1-1 -- . ':!debian'
+
+(If you have dgit, use `dgit clone foo`, rather than plain `git
+clone`.)
+
+A single combined diff, containing all the changes, follows.
diff --git a/debian/trc_pkt_lister.1 b/debian/trc_pkt_lister.1
new file mode 100644
index 0000000..f16797c
--- /dev/null
+++ b/debian/trc_pkt_lister.1
@@ -0,0 +1,122 @@
+.\" Hey, EMACS: -*- nroff -*-
+.TH TRC_PKT_LISTER 1 "2018-03-28"
+
+.SH NAME
+trc_pkt_lister \- decodes captured CoreSight\*R trace
+.SH SYNOPSIS
+.RI trc_pkt_lister
+[ \-ss_dir \fI<dir>\fP ]
+[ -ss_verbose ]
+[ \-id \fI<n>\fP ]
+[ \-src_name \fI<name>\fP ]
+[ \-decode ]
+[ \-decode_only ]
+[ \-o_raw_packed ]
+[ \-o_raw_unpacked ]
+[ \-logstdout ]
+[ \-logstderr ]
+[ \-logfile ]
+[ \-logfilename \fI<name>\fP ]
+.br
+.SH DESCRIPTION
+.B trc_pkt_lister
+is a tool that takes a snapshot directory as an input, and lists and/or
+decodes all the trace packets for a single source, for any currently
+supported protocol.
+.PP
+The output will be a list of discrete packets, generic output packets
+and any error messages to file and/or screen as selected by the input
+command line options.
+.PP
+By default the program will list packets only (no decode), for the
+first discovered trace sink (ETB, ETF, ETR) in the snapshot directory,
+with all streams output.
+.SH OPTIONS
+.SS Snapshot selection
+The program defaults to \./ if no \-ss_dir option is given
+.TP
+.B \-ss\_dir <dir>
+Set the directory path to a trace snapshot.
+.TP
+\fB\fC\-ss\_verbose\fR
+Verbose output when reading the snapshot.
+.SS Decode options
+.TP
+.B \-id <n>
+Set an ID to list (may be used multiple times) \- default if no id set is for all IDs to be printed.
+.TP
+.B \-src\_name <name>
+List packets from a given snapshot source name (defaults to first source found).
+.TP
+.B \-decode
+Full decode of the packets from the trace snapshot (default is to list undecoded packets only.
+.TP
+.B \-decode_only
+Does not list the undecoded packets, just the trace decode.
+.TP
+.B \-o\_raw\_packed
+Output raw packed trace frames.
+.TP
+.B \-o\_raw\_unpacked
+Output raw unpacked trace data per ID.
+.SS Output options
+Default is to output to file and stdout. Setting any option overrides and limits to only
+the options set.
+.TP
+.B \-logstdout
+output to stdout.
+.TP
+.B \-logstderr
+output to stderr.
+.TP
+.B \-logfile
+output to file using the default log file name.
+.TP
+.B \-logfilename <name>
+change the name of the output log file.
+.SH FILES
+.B Trace Snapshot directory.
+.PP
+The \fR./tests/snapshots\fP directory contains a number of trace
+snapshots used for testing the library. Trace snapshots are dumps of
+captured binary trace data, CoreSight component configurations and
+memory dumps to allow trace decode.
+.PP
+Snapshots are generated on ARM targets and can then be analysed
+offline. The snapshot format is available in a separate document.
+.SH EXAMPLE
+Example command lines with short output excerpts.
+.PP
+.BI TC2 " ETMv3 packet processor output, raw packet output."
+.br
+Command line:
+.br
+.RI "trc\_pkt\_lister -ss\_dir ../../snapshots/TC2 -o_raw_unpacked"
+.PP
+Output:
+.br
+Frame Data; Index 17958; ID_DATA[0x11]; 16 04 c0 86 42 97 e1 c4
+.br
+Idx:17945; ID:11; I_SYNC : Instruction Packet synchronisation.; (Periodic); Addr=0xc00
+416e2; S; ISA=Thumb2;
+.br
+Idx:17961; ID:11; P_HDR : Atom P-header.; WEN; Cycles=1
+.br
+Frame Data; Index 17968; ID_DATA[0x11]; ce af 90 80 80 00 a4 84 a0 84 a4 88
+.br
+Idx:17962; ID:11; TIMESTAMP : Timestamp Value.; TS=0x82f9d13097 (562536984727)
+.br
+Idx:17974; ID:11; P_HDR : Atom P-header.; WW; Cycles=2
+.PP
+.BI Juno " ETB\_1 selected for STM packet output, raw packet output"
+.br
+Command line:
+.br
+.RI "trc\_pkt\_lister -ss\_dir ../../snapshots/juno_r1_1 -o\_raw\_unpacked -src\_name ETB\_1"
+.PP
+.BI Juno " ETMv4 full trace decode + packet monitor, source trace ID 0x10 only."
+.br
+Command line:
+.br
+.RI "trc\_pkt\_lister -ss\_dir ../../snapshots/juno\_r1\_1 -decode -id 0x10"
+
diff --git a/debian/watch b/debian/watch
new file mode 100644
index 0000000..d516280
--- /dev/null
+++ b/debian/watch
@@ -0,0 +1,10 @@
+# Compulsory line, this is a version 4 file
+version=4
+
+# PGP signature mangle, so foo.tar.gz has foo.tar.gz.sig
+#opts="pgpsigurlmangle=s%$%.sig%"
+
+# GitHub hosted projects
+opts=filenamemangle=s%(?:.*?)?v?(\d[\d.]*)\.tar\.gz%libopencsd-$1.tar.gz% \
+ https://github.com/Linaro/OpenCSD/tags \
+ (?:.*?/)?v?(\d[\d.]*)\.tar\.gz debian uupdate