linux-kernel - [patch v3] perf_event_open.2: Exclude_host/exclude

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Date:	Tue, 21 Jul 2015 12:05:38 -0400 (EDT)
From:	Vince Weaver <vincent.weaver@...ne.edu>
To:	"Michael Kerrisk (man-pages)" <mtk.manpages@...il.com>
cc:	linux-man@...r.kernel.org, linux-kernel@...r.kernel.org,
	Peter Zijlstra <a.p.zijlstra@...llo.nl>,
	Ingo Molnar <mingo@...hat.com>,
	Arnaldo Carvalho de Melo <acme@...nel.org>,
	Gleb Natapov <gleb@...nel.org>, Joerg Roedel <joro@...tes.org>
Subject: [patch v3] perf_event_open.2: Exclude_host/exclude_guest
 clarification


This patch relates to the exclude_host and exclude_guest bits added
by the following commit:

   exclude_host, exclude_guest; Linux 3.2
        commit a240f76165e6255384d4bdb8139895fac7988799
        Author: Joerg Roedel <joerg.roedel@....com>
        Date:   Wed Oct 5 14:01:16 2011 +0200

            perf, core: Introduce attrs to count in either host or guest mode

            Signed-off-by: Joerg Roedel <joerg.roedel@....com>
            Signed-off-by: Gleb Natapov <gleb@...hat.com>
            Signed-off-by: Peter Zijlstra <a.p.zijlstra@...llo.nl>
            Link: http://lkml.kernel.org/r/1317816084-18026-2-git-send-email-gleb@redhat.com
            Signed-off-by: Ingo Molnar <mingo@...e.hu>

The updated manpage text clarifies that the "exclude_host" and
"exclude_guest" perf_event_open() attr bits only apply in the
context of a KVM environment and are currently x86 only.

The patch is the same as the previous version with the addition
of Joerf Roedel's ACK.

Signed-off-by: Vince Weaver <vincent.weaver@...ne.edu>
Acked-by: Joerg Roedel <jroedel@...e.de>

diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index 39c8d8c..1ea56c9 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -1006,11 +1006,25 @@ struct sample_id {
 .TP
 .IR "exclude_host" " (since Linux 3.2)"
 .\" commit a240f76165e6255384d4bdb8139895fac7988799
-Do not measure time spent in VM host.
+When conducting measurements that include processes running
+VM instances (i.e. have executed a
+.I KVM_RUN
+.BR ioctl (2)
+) only measure events happening inside a guest instance.
+This is only meaningful outside the guests; this setting does
+not change counts gathered inside of a guest.
+Currently this functionality is x86 only.
 .TP
 .IR "exclude_guest" " (since Linux 3.2)"
 .\" commit a240f76165e6255384d4bdb8139895fac7988799
-Do not measure time spent in VM guest.
+When conducting measurements that include processes running
+VM instances (i.e. have executed a
+.I KVM_RUN
+.BR ioctl (2)
+) do not measure events happening inside guest instances.
+This is only meaningful outside the guests; this setting does
+not change counts gathered inside of a guest.
+Currently this functionality is x86 only.
 .TP
 .IR "exclude_callchain_kernel" " (since Linux 3.7)"
 .\" commit d077526485d5c9b12fe85d0b2b3b7041e6bc5f91
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/