Clarify the perf_event_open behavior with respect to the disabled bit and creating event groups. Reported-by: Sudhanshu Goswami <Sudhanshu.Goswami@xxxxxxx> Signed-off-by: Vince Weaver <vincent.weaver@xxxxxxxxx> diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 6d42c41..f5de495 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -739,6 +739,17 @@ If disabled, the event can later be enabled by .BR prctl (2), or .IR enable_on_exec . + +When creating an event group, typically the group leader is initialized +with +.I disabled +set to 1 and any child events are initialized with +.I disabled +set to 0. +Despite +.I disabled +being 0, the child events will not start until the group leader +is enabled. .TP .IR "inherit" The -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
