Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1506304

Re: [PATCH 2/2] perf_event_open.2: Document write_backward

Path csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From Vince Weaver <vincent.weaver@maine.edu>
Newsgroups linux.kernel
Subject Re: [PATCH 2/2] perf_event_open.2: Document write_backward
Date Fri, 21 Oct 2016 23:30:01 +0200
Message-ID <suPy1-2Jv-7@gated-at.bofh.it> (permalink)
References <suGl5-4T9-35@gated-at.bofh.it> <suGuJ-4WC-1@gated-at.bofh.it>
X-Original-To Wang Nan <wangnan0@huawei.com>
Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=maine.edu; s=google; h=from:date:to:cc:subject:in-reply-to:message-id:references :user-agent:mime-version; bh=Ph6VDcc4ORqOFIrJzLS+uhV3hgxjy6Xj9PMpsxnA4Ck=; b=CgZiXLGhMXa0+Jx1FR1pFktAntvo49qap7QhOq0uAZB6dob+3N0mTqGnq6zrx4qL11 3Haa+nIZ5lETKRJFvBDrOYNe0zvoM2lCdelLsNjXzeZ+jjlI92MLtVHPqXZQvuQK/tn4 grDK42WhvdUgZOMz2RhtKLQYkhLALVFHxwCI8=
X-Google-Dkim-Signature v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:date:to:cc:subject:in-reply-to:message-id :references:user-agent:mime-version; bh=Ph6VDcc4ORqOFIrJzLS+uhV3hgxjy6Xj9PMpsxnA4Ck=; b=mEljnsaoi55BZ33ubsBp1Q+Fswz5cPGj97VcB20DuNIITB97aBwB/CcE2H7hfiovdu AwRzUhHNCaUXT1G8TtbTgawoIi17YFlSNVn4Uyes05QL5KOJh5Bzeu5ANpoPcxsVSEkA qfCa7B5025+08e2lZDLNBUVRDR5SpWodgSYpsiZw0s/U4RO0edj+oa/1DbIwrXntOxDk duZE04Xd4XWaQ+kco1oN8660Vwgh+Gr8wUh+bGenw8koEI58jQbeXNE+dJHeKYuf56OR 2PPw5XYJcVOFuwC8w12MojQQf8FyFWHusVIQHs3WkzhXn7d+b2aGQXiFAO9+5vCAJqfp oj7Q==
X-Gm-Message-State ABUngveQ6Nq4HskjjGWP8fCWf32o0x1E+iAgXkIK50S1ZWSoBAzAcPer2QLvVTZt3U9gdxgt
X-Received by 10.107.142.134 with SMTP id q128mr3085518iod.109.1477085141891; Fri, 21 Oct 2016 14:25:41 -0700 (PDT)
X-Google-Original-From Vince Weaver <vince@maine.edu>
X-X-Sender vince@macbook-air
User-Agent Alpine 2.20 (DEB 67 2015-01-07)
MIME-Version 1.0
Content-Type text/plain; charset=US-ASCII
Sender robomod@news.nic.it
List-ID <linux-kernel.vger.kernel.org>
X-Mailing-List linux-kernel@vger.kernel.org
Approved robomod@news.nic.it
Lines 35
Organization linux.* mail to news gateway
X-Original-Cc mtk.manpages@gmail.com, pi3orama@163.com, linux-kernel@vger.kernel.org, linux-man@vger.kernel.org, lizefan@huawei.com, vincent.weaver@maine.edu
X-Original-Date Fri, 21 Oct 2016 17:25:40 -0400 (EDT)
X-Original-Message-ID <alpine.DEB.2.20.1610211716280.16183@macbook-air>
X-Original-References <1477049893-143199-1-git-send-email-wangnan0@huawei.com> <1477049893-143199-2-git-send-email-wangnan0@huawei.com>
X-Original-Sender linux-kernel-owner@vger.kernel.org
Xref csiph.com linux.kernel:1506304

Show key headers only | View raw


On Fri, 21 Oct 2016, Wang Nan wrote:

>            context_switch :  1,  /* context switch data */
> -
> -          __reserved_1   : 37;
> +          write_backward :  1,  /* Write ring buffer from end to beginning */
> +          __reserved_1   : 36;

This removes a blank line, not sure if intentional or not.

> +.IR "write_backward" " (since Linux 4.6)"

It didn't committed until Linux 4.7 from what I can tell?

> +This makes the resuling event use a backward ring-buffer, which
resulting

> +writes samples from the end of the ring-buffer.
> +
> +It is not allowed to connect events with backward and forward
> +ring-buffer settings together using
> +.B PERF_EVENT_IOC_SET_OUTPUT.
> +
> +Backward ring-buffer is useful when the ring-buffer is overwritable
> +(created by readonly
> +.BR mmap (2)
> +). 

A ring buffer is over-writable when it is mmapped readonly?
Is this a hard requirement?
Can you set the read-backwards bit if not mapped readonly?

Otherwise the documentation seems reasonable.

Reviewed-by: Vince Weaver <vincent.weaver@maine.edu>

Back to linux.kernel | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

[PATCH 1/2] perf_event_open.2: Document PERF_EVENT_IOC_PAUSE_OUTPUT Wang Nan <wangnan0@huawei.com> - 2016-10-21 13:40 +0200
  [PATCH 2/2] perf_event_open.2: Document write_backward Wang Nan <wangnan0@huawei.com> - 2016-10-21 13:50 +0200
    Re: [PATCH 2/2] perf_event_open.2: Document write_backward Vince Weaver <vincent.weaver@maine.edu> - 2016-10-21 23:30 +0200
      Re: [PATCH 2/2] perf_event_open.2: Document write_backward "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-10-22 12:10 +0200
        Re: [PATCH 2/2] perf_event_open.2: Document write_backward "Wangnan (F)" <wangnan0@huawei.com> - 2016-10-24 08:50 +0200
  Re: [PATCH 1/2] perf_event_open.2: Document  PERF_EVENT_IOC_PAUSE_OUTPUT Vince Weaver <vincent.weaver@maine.edu> - 2016-10-21 23:20 +0200
    Re: [PATCH 1/2] perf_event_open.2: Document  PERF_EVENT_IOC_PAUSE_OUTPUT "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-10-22 12:10 +0200
  Re: [PATCH 1/2] perf_event_open.2: Document  PERF_EVENT_IOC_PAUSE_OUTPUT "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> - 2016-10-22 12:10 +0200

csiph-web