Re: perf documentation: update Documentation/ABI/testing with missing perf-related files

2013-07-16 Thread Jiri Olsa
On Mon, Jul 15, 2013 at 05:38:15PM -0400, Vince Weaver wrote:
> 
> Add documentation for various files perf_event creates under
> /sys/bus/event_source/devices//
> 
> Signed-off-by: Vince Weaver 
> 
> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices 
> b/Documentation/ABI/testing/sysfs-bus-event_source-devices
> new file mode 100644
> index 000..ffa2e4b
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices
> @@ -0,0 +1,50 @@
> +What:/sys/bus/event_source/devices//cpumask
> +
> +Date:2012/09/10
> + 

nit, white space above

> +Contact: Linux kernel mailing list 
> +
> +Description: This value holds a representative core for each
> + socket in a system.  It is meant to help when
> + creating a perf_event event for socket-wide events
> + like uncore and northbridge events.
> +
> + The format is a comma separated list of cpu numbers,
> + one for each socket in the system that the PMU in
> + question can run on.
> +
> + For example, on a two-socket Sandybridge-EP machine and
> + the cbox0 uncore the value of the file will be:
> + 0,8
> + 

nit, white space above

> +
> +
> +What:/sys/bus/event_source/devices/cpu/rdpmc
> +
> +Date:2011/11/20
> +
> +Contact: Linux kernel mailing list 
> +
> +Description: Indicates whether a CPU allows userspace "rdpmc"
> + instructions (unprivileged reads of the performance
> + counter MSRs).
> +
> + You can echo 0 to this value to disable user rdpmc
> + access.
> +
> +
> +
> +What:/sys/bus/event_source/devices//type
> +
> +Date:2013/01/08
> +
> +Contact: Linux kernel mailing list 
> +
> +Description: This value holds the PMU (Performance Monitor Unit) type
> + value that is passed into the perf_event_open()
> + attr:type field when opening an event.
> +
> + The value is a decimal integer.
> +
> +
> +

Acked-by: Jiri Olsa 

thanks,
jirka
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


Re: perf documentation: update Documentation/ABI/testing with missing perf-related files

2013-07-16 Thread Jiri Olsa
On Mon, Jul 15, 2013 at 05:38:15PM -0400, Vince Weaver wrote:
 
 Add documentation for various files perf_event creates under
 /sys/bus/event_source/devices/dev/
 
 Signed-off-by: Vince Weaver vincent.wea...@maine.edu
 
 diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices 
 b/Documentation/ABI/testing/sysfs-bus-event_source-devices
 new file mode 100644
 index 000..ffa2e4b
 --- /dev/null
 +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices
 @@ -0,0 +1,50 @@
 +What:/sys/bus/event_source/devices/dev/cpumask
 +
 +Date:2012/09/10
 + 

nit, white space above

 +Contact: Linux kernel mailing list linux-kernel@vger.kernel.org
 +
 +Description: This value holds a representative core for each
 + socket in a system.  It is meant to help when
 + creating a perf_event event for socket-wide events
 + like uncore and northbridge events.
 +
 + The format is a comma separated list of cpu numbers,
 + one for each socket in the system that the PMU in
 + question can run on.
 +
 + For example, on a two-socket Sandybridge-EP machine and
 + the cbox0 uncore the value of the file will be:
 + 0,8
 + 

nit, white space above

 +
 +
 +What:/sys/bus/event_source/devices/cpu/rdpmc
 +
 +Date:2011/11/20
 +
 +Contact: Linux kernel mailing list linux-kernel@vger.kernel.org
 +
 +Description: Indicates whether a CPU allows userspace rdpmc
 + instructions (unprivileged reads of the performance
 + counter MSRs).
 +
 + You can echo 0 to this value to disable user rdpmc
 + access.
 +
 +
 +
 +What:/sys/bus/event_source/devices/dev/type
 +
 +Date:2013/01/08
 +
 +Contact: Linux kernel mailing list linux-kernel@vger.kernel.org
 +
 +Description: This value holds the PMU (Performance Monitor Unit) type
 + value that is passed into the perf_event_open()
 + attr:type field when opening an event.
 +
 + The value is a decimal integer.
 +
 +
 +

Acked-by: Jiri Olsa jo...@redhat.com

thanks,
jirka
--
To unsubscribe from this list: send the line unsubscribe linux-kernel in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


perf documentation: update Documentation/ABI/testing with missing perf-related files

2013-07-15 Thread Vince Weaver

Add documentation for various files perf_event creates under
/sys/bus/event_source/devices//

Signed-off-by: Vince Weaver 

diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices 
b/Documentation/ABI/testing/sysfs-bus-event_source-devices
new file mode 100644
index 000..ffa2e4b
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices
@@ -0,0 +1,50 @@
+What:  /sys/bus/event_source/devices//cpumask
+
+Date:  2012/09/10
+   
+Contact:   Linux kernel mailing list 
+
+Description:   This value holds a representative core for each
+   socket in a system.  It is meant to help when
+   creating a perf_event event for socket-wide events
+   like uncore and northbridge events.
+
+   The format is a comma separated list of cpu numbers,
+   one for each socket in the system that the PMU in
+   question can run on.
+
+   For example, on a two-socket Sandybridge-EP machine and
+   the cbox0 uncore the value of the file will be:
+   0,8
+   
+
+
+What:  /sys/bus/event_source/devices/cpu/rdpmc
+
+Date:  2011/11/20
+
+Contact:   Linux kernel mailing list 
+
+Description:   Indicates whether a CPU allows userspace "rdpmc"
+   instructions (unprivileged reads of the performance
+   counter MSRs).
+
+   You can echo 0 to this value to disable user rdpmc
+   access.
+
+
+
+What:  /sys/bus/event_source/devices//type
+
+Date:  2013/01/08
+
+Contact:   Linux kernel mailing list 
+
+Description:   This value holds the PMU (Performance Monitor Unit) type
+   value that is passed into the perf_event_open()
+   attr:type field when opening an event.
+
+   The value is a decimal integer.
+
+
+
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


perf documentation: update Documentation/ABI/testing with missing perf-related files

2013-07-15 Thread Vince Weaver

Add documentation for various files perf_event creates under
/sys/bus/event_source/devices/dev/

Signed-off-by: Vince Weaver vincent.wea...@maine.edu

diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices 
b/Documentation/ABI/testing/sysfs-bus-event_source-devices
new file mode 100644
index 000..ffa2e4b
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices
@@ -0,0 +1,50 @@
+What:  /sys/bus/event_source/devices/dev/cpumask
+
+Date:  2012/09/10
+   
+Contact:   Linux kernel mailing list linux-kernel@vger.kernel.org
+
+Description:   This value holds a representative core for each
+   socket in a system.  It is meant to help when
+   creating a perf_event event for socket-wide events
+   like uncore and northbridge events.
+
+   The format is a comma separated list of cpu numbers,
+   one for each socket in the system that the PMU in
+   question can run on.
+
+   For example, on a two-socket Sandybridge-EP machine and
+   the cbox0 uncore the value of the file will be:
+   0,8
+   
+
+
+What:  /sys/bus/event_source/devices/cpu/rdpmc
+
+Date:  2011/11/20
+
+Contact:   Linux kernel mailing list linux-kernel@vger.kernel.org
+
+Description:   Indicates whether a CPU allows userspace rdpmc
+   instructions (unprivileged reads of the performance
+   counter MSRs).
+
+   You can echo 0 to this value to disable user rdpmc
+   access.
+
+
+
+What:  /sys/bus/event_source/devices/dev/type
+
+Date:  2013/01/08
+
+Contact:   Linux kernel mailing list linux-kernel@vger.kernel.org
+
+Description:   This value holds the PMU (Performance Monitor Unit) type
+   value that is passed into the perf_event_open()
+   attr:type field when opening an event.
+
+   The value is a decimal integer.
+
+
+
--
To unsubscribe from this list: send the line unsubscribe linux-kernel in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/