Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754951AbcJPCDD (ORCPT ); Sat, 15 Oct 2016 22:03:03 -0400 Received: from mail-io0-f196.google.com ([209.85.223.196]:33002 "EHLO mail-io0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752742AbcJPCC7 (ORCPT ); Sat, 15 Oct 2016 22:02:59 -0400 From: Vince Weaver X-Google-Original-From: Vince Weaver Date: Sat, 15 Oct 2016 22:02:51 -0400 (EDT) X-X-Sender: vince@macbook-air To: "Michael Kerrisk (man-pages)" cc: linux-man@vger.kernel.org, linux-kernel@vger.kernel.org, Kan Liang , Peter Zijlstra , Ingo Molnar , Stephane Eranian Subject: [patch] perf_event_open.2: PERF_RECORD_LOST_SAMPLES record type 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: 981 Lines: 37 Linux 4.2 added a new record type: PERF_RECORD_LOST_SAMPLES It is generated when hardware samples (currently only Intel PEBS) are lost. Signed-off-by: Vince Weaver diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 9f33122..a47df2d 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -2551,6 +2551,25 @@ process ID of the thread starting an instruction trace. .I tid thread ID of the thread starting an instruction trace. .RE +.TP +.BR PERF_RECORD_LOST_SAMPLES " (since Linux 4.2)" +\" f38b0dbb491a6987e198aa6b428db8692a6480f8 +When using hardware sampling (such as Intel PEBS) this record +indicates some number of samples may have been lost. + +.in +4n +.nf +struct { + struct perf_event_header header; + u64 lost; + struct sample_id sample_id; +}; +.fi +.RS +.TP +.I lost +the number of potentially lost samples. +.RE .RE .SS Overflow handling Events can be set to notify when a threshold is crossed,