User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

cpu-mask

Specify CPU(s) for a collect or collect-with action.

GUI Equivalent

Configure Analysis window > WHAT pane > Advanced section > CPU mask option

Syntax

-cpu-mask=<cpu_mask1>,<cpu_mask3>-<cpu_mask5>...

Arguments

CPU number or a range of numbers.

Default

ALL

The hardware event-based sampling collector collects data on all CPUs in the system.

Actions Modified

collect, collect-with

Description

This option specifies the CPU(s) for which data will be collected during hardware event-based sampling collection. Specify a list of comma-separated CPU IDs (with no spaces) and/or the range(s) of CPU IDs. A range is represented by a beginning and ending ID, separated by a dash.

Example

This example collects samples on four CPUs (1, 3, 4, and 5) for a Linux sample application.

vtune -collect hotspots -knob sampling-mode=hw -cpu-mask 1,3-5  -- /home/test/sample