mirror of
https://git.haproxy.org/git/haproxy.git/
synced 2025-08-13 02:26:56 +02:00
156430ceb6
We'll need to let the user decide what's best for their workload, and in order to do this we'll have to provide tunable options. For that, we're introducing struct ha_cpu_policy which contains a name, a description and a function pointer. The purpose will be to use that function pointer to choose the best CPUs to use and now to set the number of threads and thread-groups, that will be called during the thread setup phase. The only supported policy for now is "none" which doesn't set/touch anything (i.e. all available CPUs are used).
80 lines
2.6 KiB
C
80 lines
2.6 KiB
C
#ifndef _HAPROXY_CPU_TOPO_H
|
|
#define _HAPROXY_CPU_TOPO_H
|
|
|
|
#include <haproxy/api.h>
|
|
#include <haproxy/cpuset-t.h>
|
|
#include <haproxy/cpu_topo-t.h>
|
|
|
|
extern int cpu_topo_maxcpus;
|
|
extern int cpu_topo_lastcpu;
|
|
extern struct ha_cpu_topo *ha_cpu_topo;
|
|
|
|
/* non-zero if we're certain that taskset or similar was used to force CPUs */
|
|
extern int cpu_mask_forced;
|
|
|
|
/* Detects CPUs that are online on the system. It may rely on FS access (e.g.
|
|
* /sys on Linux). Returns the number of CPUs detected or 0 if the detection
|
|
* failed.
|
|
*/
|
|
int ha_cpuset_detect_online(struct hap_cpuset *set);
|
|
|
|
/* Detects the CPUs that will be used based on the ones the process is bound to.
|
|
* Returns non-zero on success, zero on failure. Note that it may not be
|
|
* performed in the function above because some calls may rely on other items
|
|
* being allocated (e.g. trash).
|
|
*/
|
|
int cpu_detect_usable(void);
|
|
|
|
/* detect the CPU topology based on info in /sys */
|
|
int cpu_detect_topology(void);
|
|
|
|
/* fix missing info in the CPU topology */
|
|
void cpu_fixup_topology(void);
|
|
|
|
/* compose clusters */
|
|
void cpu_compose_clusters(void);
|
|
|
|
/* apply remaining topology-based cpu set restrictions */
|
|
void cpu_refine_cpusets(void);
|
|
|
|
/* apply the chosen CPU policy. Returns < 0 on failure with a message in *err
|
|
* that must be freed by the caller if non-null.
|
|
*/
|
|
int cpu_apply_policy(int tmin, int tmax, int gmin, int gmax, char **err);
|
|
|
|
/* Detects CPUs that are bound to the current process. Returns the number of
|
|
* CPUs detected or 0 if the detection failed.
|
|
*/
|
|
int ha_cpuset_detect_bound(struct hap_cpuset *set);
|
|
|
|
/* Returns true if at least one cpu-map directive was configured, otherwise
|
|
* false.
|
|
*/
|
|
int cpu_map_configured(void);
|
|
|
|
/* Dump the CPU topology <topo> for up to cpu_topo_maxcpus CPUs for
|
|
* debugging purposes. Offline CPUs are skipped.
|
|
*/
|
|
void cpu_dump_topology(const struct ha_cpu_topo *topo);
|
|
|
|
/* re-order a CPU topology array by locality to help form groups. */
|
|
void cpu_reorder_by_locality(struct ha_cpu_topo *topo, int entries);
|
|
|
|
/* re-order a CPU topology array by CPU index only, to undo the function above,
|
|
* in case other calls need to be made on top of this.
|
|
*/
|
|
void cpu_reorder_by_index(struct ha_cpu_topo *topo, int entries);
|
|
|
|
/* re-order a CPU topology array by cluster id. */
|
|
void cpu_reorder_by_cluster(struct ha_cpu_topo *topo, int entries);
|
|
|
|
/* Functions used by qsort to compare hardware CPUs (not meant to be used from
|
|
* outside cpu_topo).
|
|
*/
|
|
int _cmp_cpu_index(const void *a, const void *b);
|
|
int _cmp_cpu_locality(const void *a, const void *b);
|
|
int _cmp_cpu_cluster(const void *a, const void *b);
|
|
int _cmp_cpu_cluster_capa(const void *a, const void *b);
|
|
|
|
#endif /* _HAPROXY_CPU_TOPO_H */
|