Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932624AbbGUP7E (ORCPT ); Tue, 21 Jul 2015 11:59:04 -0400 Received: from mail-ig0-f173.google.com ([209.85.213.173]:35652 "EHLO mail-ig0-f173.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754146AbbGUP7B (ORCPT ); Tue, 21 Jul 2015 11:59:01 -0400 From: Vince Weaver X-Google-Original-From: Vince Weaver Date: Tue, 21 Jul 2015 12:05:38 -0400 (EDT) To: "Michael Kerrisk (man-pages)" cc: linux-man@vger.kernel.org, linux-kernel@vger.kernel.org, Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Gleb Natapov , Joerg Roedel Subject: [patch v3] perf_event_open.2: Exclude_host/exclude_guest clarification Message-ID: User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2573 Lines: 64 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 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 Signed-off-by: Gleb Natapov Signed-off-by: Peter Zijlstra Link: http://lkml.kernel.org/r/1317816084-18026-2-git-send-email-gleb@redhat.com Signed-off-by: Ingo Molnar 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 Acked-by: Joerg Roedel 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@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/