xref: /linux/tools/perf/util/target.h (revision c0c914eca7f251c70facc37dfebeaf176601918d)
1 #ifndef _PERF_TARGET_H
2 #define _PERF_TARGET_H
3 
4 #include <stdbool.h>
5 #include <sys/types.h>
6 
7 struct target {
8 	const char   *pid;
9 	const char   *tid;
10 	const char   *cpu_list;
11 	const char   *uid_str;
12 	uid_t	     uid;
13 	bool	     system_wide;
14 	bool	     uses_mmap;
15 	bool	     default_per_cpu;
16 	bool	     per_thread;
17 };
18 
19 enum target_errno {
20 	TARGET_ERRNO__SUCCESS		= 0,
21 
22 	/*
23 	 * Choose an arbitrary negative big number not to clash with standard
24 	 * errno since SUS requires the errno has distinct positive values.
25 	 * See 'Issue 6' in the link below.
26 	 *
27 	 * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/errno.h.html
28 	 */
29 	__TARGET_ERRNO__START		= -10000,
30 
31 	/* for target__validate() */
32 	TARGET_ERRNO__PID_OVERRIDE_CPU	= __TARGET_ERRNO__START,
33 	TARGET_ERRNO__PID_OVERRIDE_UID,
34 	TARGET_ERRNO__UID_OVERRIDE_CPU,
35 	TARGET_ERRNO__PID_OVERRIDE_SYSTEM,
36 	TARGET_ERRNO__UID_OVERRIDE_SYSTEM,
37 	TARGET_ERRNO__SYSTEM_OVERRIDE_THREAD,
38 
39 	/* for target__parse_uid() */
40 	TARGET_ERRNO__INVALID_UID,
41 	TARGET_ERRNO__USER_NOT_FOUND,
42 
43 	__TARGET_ERRNO__END,
44 };
45 
46 enum target_errno target__validate(struct target *target);
47 enum target_errno target__parse_uid(struct target *target);
48 
49 int target__strerror(struct target *target, int errnum, char *buf, size_t buflen);
50 
51 static inline bool target__has_task(struct target *target)
52 {
53 	return target->tid || target->pid || target->uid_str;
54 }
55 
56 static inline bool target__has_cpu(struct target *target)
57 {
58 	return target->system_wide || target->cpu_list;
59 }
60 
61 static inline bool target__none(struct target *target)
62 {
63 	return !target__has_task(target) && !target__has_cpu(target);
64 }
65 
66 static inline bool target__uses_dummy_map(struct target *target)
67 {
68 	bool use_dummy = false;
69 
70 	if (target->default_per_cpu)
71 		use_dummy = target->per_thread ? true : false;
72 	else if (target__has_task(target) ||
73 	         (!target__has_cpu(target) && !target->uses_mmap))
74 		use_dummy = true;
75 
76 	return use_dummy;
77 }
78 
79 #endif /* _PERF_TARGET_H */
80