sa.h

/*
 * sar/sadc: Report system activity
 * (C) 1999-2024 by Sebastien Godard (sysstat <at> orange.fr)
 */

#ifndef _SA_H
#define _SA_H

#include <stdio.h>
#include <stdint.h>

#include "common.h"
#include "rd_stats.h"
#include "rd_sensors.h"

/*
 ***************************************************************************
 * Activity identification values.
 ***************************************************************************
 */

/* Number of activities */
#define NR_ACT		43
/* The value below is used for sanity check */
#define MAX_NR_ACT	256

/* Number of functions used to count items */
#define NR_F_COUNT	14

/* Activities */
enum {
	A_CPU 		= 1,
	A_PCSW		= 2,
	A_IRQ		= 3,
	A_SWAP		= 4,
	A_PAGE		= 5,
	A_IO		= 6,
	A_MEMORY	= 7,
	A_KTABLES	= 8,
	A_QUEUE		= 9,
	A_SERIAL	= 10,
	A_DISK		= 11,
	A_NET_DEV	= 12,
	A_NET_EDEV	= 13,
	A_NET_NFS	= 14,
	A_NET_NFSD	= 15,
	A_NET_SOCK	= 16,
	A_NET_IP	= 17,
	A_NET_EIP	= 18,
	A_NET_ICMP	= 19,
	A_NET_EICMP	= 20,
	A_NET_TCP	= 21,
	A_NET_ETCP	= 22,
	A_NET_UDP	= 23,
	A_NET_SOCK6	= 24,
	A_NET_IP6	= 25,
	A_NET_EIP6	= 26,
	A_NET_ICMP6	= 27,
	A_NET_EICMP6	= 28,
	A_NET_UDP6	= 29,
	A_PWR_CPU	= 30,
	A_PWR_FAN	= 31,
	A_PWR_TEMP	= 32,
	A_PWR_IN	= 33,
	A_HUGE		= 34,
	A_PWR_FREQ	= 35,
	A_PWR_USB	= 36,
	A_FS		= 37,
	A_NET_FC	= 38,
	A_NET_SOFT	= 39,
	A_PSI_CPU	= 40,
	A_PSI_IO	= 41,
	A_PSI_MEM	= 42,
	A_PWR_BAT	= 43
};

/* Macro used to flag an activity that should be collected */
#define COLLECT_ACTIVITY(m)	act[get_activity_position(act, m, EXIT_IF_NOT_FOUND)]->options |= AO_COLLECTED

/* Macro used to flag an activity that should be selected */
#define SELECT_ACTIVITY(m)	act[get_activity_position(act, m, EXIT_IF_NOT_FOUND)]->options |= AO_SELECTED


/*
 ***************************************************************************
 * Flags.
 ***************************************************************************
 */

#define S_F_SINCE_BOOT		0x00000001
#define S_F_SA_ROTAT      	0x00000002	/* Only used by sadc */
#define S_F_DEV_SID		0x00000002	/* Only used by sar/sadf */
#define S_F_PRETTY		0x00000004
#define S_F_FORCE_FILE		0x00000008
#define S_F_INTERVAL_SET	0x00000010
#define S_F_TRUE_TIME		0x00000020
#define S_F_LOCK_FILE		0x00000040
#define S_F_SEC_EPOCH		0x00000080
#define S_F_HDR_ONLY		0x00000100
#define S_F_FILE_LOCKED		0x00000200
#define S_F_SA_YYYYMMDD		0x00000400
#define S_F_HORIZONTALLY	0x00000800
#define S_F_COMMENT		0x00001000
#define S_F_PERSIST_NAME	0x00002000
#define S_F_LOCAL_TIME		0x00004000
#define S_F_PREFD_TIME_OUTPUT	0x00008000
#define S_F_SVG_SKIP		0x00010000
#define S_F_SVG_AUTOSCALE	0x00020000
#define S_F_SVG_ONE_DAY		0x00040000
#define S_F_SVG_SHOW_IDLE	0x00080000
#define S_F_UNIT		0x00100000
#define S_F_SVG_HEIGHT		0x00200000
#define S_F_SVG_PACKED		0x00400000
#define S_F_SVG_SHOW_INFO	0x00800000
#define S_F_MINMAX		0x01000000
#define S_F_ZERO_OMIT		0x02000000
#define S_F_SVG_SHOW_TOC	0x04000000
#define S_F_FDATASYNC		0x08000000
#define S_F_OPTION_A		0x10000000
#define S_F_OPTION_P		0x20000000
#define S_F_OPTION_I		0x40000000
#define S_F_DEBUG_MODE		0x80000000

#define WANT_SINCE_BOOT(m)		(((m) & S_F_SINCE_BOOT)   == S_F_SINCE_BOOT)
#define WANT_SA_ROTAT(m)		(((m) & S_F_SA_ROTAT)     == S_F_SA_ROTAT)
#define USE_STABLE_ID(m)		(((m) & S_F_DEV_SID)      == S_F_DEV_SID)
#define DISPLAY_PRETTY(m)		(((m) & S_F_PRETTY)       == S_F_PRETTY)
#define FORCE_FILE(m)			(((m) & S_F_FORCE_FILE)   == S_F_FORCE_FILE)
#define INTERVAL_SET(m)			(((m) & S_F_INTERVAL_SET) == S_F_INTERVAL_SET)
#define PRINT_TRUE_TIME(m)		(((m) & S_F_TRUE_TIME)    == S_F_TRUE_TIME)
#define LOCK_FILE(m)			(((m) & S_F_LOCK_FILE)    == S_F_LOCK_FILE)
#define PRINT_SEC_EPOCH(m)		(((m) & S_F_SEC_EPOCH)    == S_F_SEC_EPOCH)
#define DISPLAY_HDR_ONLY(m)		(((m) & S_F_HDR_ONLY)     == S_F_HDR_ONLY)
#define FILE_LOCKED(m)			(((m) & S_F_FILE_LOCKED)  == S_F_FILE_LOCKED)
#define USE_SA_YYYYMMDD(m)		(((m) & S_F_SA_YYYYMMDD)  == S_F_SA_YYYYMMDD)
#define DISPLAY_HORIZONTALLY(m)		(((m) & S_F_HORIZONTALLY) == S_F_HORIZONTALLY)
#define DISPLAY_COMMENT(m)		(((m) & S_F_COMMENT)      == S_F_COMMENT)
#define DISPLAY_PERSIST_NAME_S(m)	(((m) & S_F_PERSIST_NAME) == S_F_PERSIST_NAME)
#define PRINT_LOCAL_TIME(m)		(((m) & S_F_LOCAL_TIME)   == S_F_LOCAL_TIME)
#define USE_PREFD_TIME_OUTPUT(m)	(((m) & S_F_PREFD_TIME_OUTPUT)   == S_F_PREFD_TIME_OUTPUT)
#define SKIP_EMPTY_VIEWS(m)		(((m) & S_F_SVG_SKIP)     == S_F_SVG_SKIP)
#define DISPLAY_ZERO_OMIT(m)		(((m) & S_F_ZERO_OMIT)    == S_F_ZERO_OMIT)
#define DISPLAY_DEBUG_MODE(m)		(((m) & S_F_DEBUG_MODE)   == S_F_DEBUG_MODE)
#define AUTOSCALE_ON(m)			(((m) & S_F_SVG_AUTOSCALE) == S_F_SVG_AUTOSCALE)
#define DISPLAY_ONE_DAY(m)		(((m) & S_F_SVG_ONE_DAY)  == S_F_SVG_ONE_DAY)
#define DISPLAY_IDLE(m)			(((m) & S_F_SVG_SHOW_IDLE) == S_F_SVG_SHOW_IDLE)
#define DISPLAY_INFO(m)			(((m) & S_F_SVG_SHOW_INFO) == S_F_SVG_SHOW_INFO)
#define DISPLAY_UNIT(m)			(((m) & S_F_UNIT)         == S_F_UNIT)
#define SET_CANVAS_HEIGHT(m)		(((m) & S_F_SVG_HEIGHT)   == S_F_SVG_HEIGHT)
#define PACK_VIEWS(m)			(((m) & S_F_SVG_PACKED)   == S_F_SVG_PACKED)
#define DISPLAY_TOC(m)			(((m) & S_F_SVG_SHOW_TOC) == S_F_SVG_SHOW_TOC)
#define FDATASYNC(m)			(((m) & S_F_FDATASYNC)    == S_F_FDATASYNC)
#define USE_OPTION_A(m)			(((m) & S_F_OPTION_A)     == S_F_OPTION_A)
#define USE_OPTION_P(m)			(((m) & S_F_OPTION_P)     == S_F_OPTION_P)
#define USE_OPTION_I(m)			(((m) & S_F_OPTION_I)     == S_F_OPTION_I)
#define DISPLAY_MINMAX(m)		(((m) & S_F_MINMAX)       == S_F_MINMAX)

#define AO_F_NULL		0x00000000

/* Output flags for options -r / -S */
#define AO_F_MEMORY		0x00000001
#define AO_F_SWAP		0x00000002
/* AO_F_MEM_ALL: See opt_flags in struct activity below */
#define AO_F_MEM_ALL		(AO_F_MEMORY << 8)

#define DISPLAY_MEMORY(m)	(((m) & AO_F_MEMORY)	== AO_F_MEMORY)
#define DISPLAY_SWAP(m)		(((m) & AO_F_SWAP)	== AO_F_SWAP)
#define DISPLAY_MEM_ALL(m)	(((m) & AO_F_MEM_ALL)	== AO_F_MEM_ALL)

/* Output flags for option -u [ ALL ] */
#define AO_F_CPU_DEF		0x00000001
#define AO_F_CPU_ALL		0x00000002

#define DISPLAY_CPU_DEF(m)	(((m) & AO_F_CPU_DEF)     == AO_F_CPU_DEF)
#define DISPLAY_CPU_ALL(m)	(((m) & AO_F_CPU_ALL)     == AO_F_CPU_ALL)

/* Output flags for option -d */
#define AO_F_DISK_PART		0x00000001

#define COLLECT_PARTITIONS(m)	(((m) & AO_F_DISK_PART)   == AO_F_DISK_PART)

/* Output flags for option -F */
#define AO_F_FILESYSTEM		0x00000001
#define AO_F_MOUNT		0x00000002

#define DISPLAY_MOUNT(m)	(((m) & AO_F_MOUNT)       == AO_F_MOUNT)

/*
 ***************************************************************************
 * Various keywords and constants.
 ***************************************************************************
 */

/* Keywords */
#define K_A_NULL	"A_NULL"
#define K_CPU		"CPU"
#define K_PSI_CPU	"CPU"
#define K_DEV		"DEV"
#define K_EDEV		"EDEV"
#define K_EICMP		"EICMP"
#define K_EICMP6	"EICMP6"
#define K_EIP		"EIP"
#define K_EIP6		"EIP6"
#define K_ETCP		"ETCP"
#define K_FAN		"FAN"
#define K_FC		"FC"
#define K_FREQ		"FREQ"
#define K_ICMP		"ICMP"
#define K_ICMP6		"ICMP6"
#define K_IN		"IN"
#define K_PSI_IO	"IO"
#define K_IP		"IP"
#define K_IP6		"IP6"
#define K_LOAD		"LOAD"
#define K_PSI_MEM	"MEM"
#define K_MOUNT		"MOUNT"
#define K_NFS		"NFS"
#define K_NFSD		"NFSD"
#define K_PSI		"PSI"
#define K_SID		"SID"
#define K_SOCK		"SOCK"
#define K_SOCK6		"SOCK6"
#define K_SOFT		"SOFT"
#define K_SUM		"SUM"
#define K_TCP		"TCP"
#define K_TEMP		"TEMP"
#define K_UDP		"UDP"
#define K_UDP6		"UDP6"
#define K_XALL		"XALL"

#define K_INT		"INT"
#define K_DISK		"DISK"
#define K_XDISK		"XDISK"
#define K_SNMP		"SNMP"
#define K_IPV6		"IPV6"
#define K_POWER		"POWER"
#define K_USB		"USB"
#define K_BAT		"BAT"

#define K_SKIP_EMPTY	"skipempty"
#define K_AUTOSCALE	"autoscale"
#define K_ONEDAY	"oneday"
#define K_SHOWIDLE	"showidle"
#define K_SHOWINFO	"showinfo"
#define K_DEBUG		"debug"
#define K_HEIGHT	"height="
#define K_PACKED	"packed"
#define K_SHOWTOC	"showtoc"
#define K_CUSTOMCOL	"customcol"
#define K_BWCOL		"bwcol"
#define K_PCPARCHIVE	"pcparchive="
#define K_HZ		"hz="

/* Environment variables */
#define ENV_COLORS_PALETTE	"S_COLORS_PALETTE"

/* Groups of activities */
#define G_DEFAULT	0x00
#define G_INT		0x01
#define G_DISK		0x02
#define G_SNMP		0x04
#define G_IPV6		0x08
#define G_POWER		0x10
#define G_XDISK		0x20

/* sadc program */
#define SADC		"sadc"

/* Time must have the format HH:MM:SS with HH in 24-hour format */
#define DEF_TMSTART	"08:00:00"
#define DEF_TMEND	"18:00:00"

#define UTSNAME_LEN	65
#define TZNAME_LEN	8
#define HEADER_LINE_LEN	512

/*
 * Define upper limit for various items.
 * Made necessary because we have to check the number of
 * items for each activity when we read a (possibly tainted)
 * sa data file.
 */
#define MAX_NR_SERIAL_LINES	65536
#define MAX_NR_DISKS		(65536 * 4096)
#define MAX_NR_IFACES		65536
#define MAX_NR_FANS		4096
#define MAX_NR_TEMP_SENSORS	4096
#define MAX_NR_IN_SENSORS	4096
#define MAX_NR_USB		65536
#define MAX_NR_FS		(65536 * 4096)
#define MAX_NR_FCHOSTS		65536
#define MAX_NR_BATS		4096

/* NR_MAX is the upper limit used for unknown activities */
#define NR_MAX		(65536 * 4096)
#define NR2_MAX		4096

/* Maximum number of args that can be passed to sadc */
#define MAX_ARGV_NR	32

/* Miscellaneous constants */
#define USE_SADC		0
#define USE_SA_FILE		1
#define NO_RESET		0
#define NO_RANGE		0
#define NON_FATAL		0
#define FATAL			1
#define H_MIN			0
#define H_MAX			1
#define C_SAR			0
#define C_SADF			1
#define ALL_ACTIVITIES		~0U
#define EXIT_IF_NOT_FOUND	1
#define RESUME_IF_NOT_FOUND	0

enum size_mode {
	SOFT_SIZE = 0,
	HARD_SIZE = 1
};

enum {
	FIRST	= 0,
	SECOND	= 1
};

enum sa_err_codes {
	END_OF_DATA_UNEXPECTED	= 1,
	INCONSISTENT_INPUT_DATA	= 2
};

enum on_eof {
	UEOF_STOP = 0,
	UEOF_CONT = 1
};

enum xml_action {
	CLOSE_XML_MARKUP = 0,
	OPEN_XML_MARKUP  = 1
};

enum json_action {
	CLOSE_JSON_MARKUP = 0,
	OPEN_JSON_MARKUP  = 1
};

enum count_mode {
	COUNT_ACTIVITIES = 0,
	COUNT_OUTPUTS    = 1
};

/* Type for all functions reading statistics */
#define __read_funct_t	void
/* Type for all functions displaying statistics */
#define __print_funct_t void

/*
 * **************************************************************************
 * Various structure definitions.
 ***************************************************************************
 */

enum time_mode {
	NO_TIME = 0,
	USE_HHMMSS_T = 1,
	USE_EPOCH_T = 2
};

/*
 * Structure for timestamps.
 * @tm_time has the GMT or local broken time representation of @epoch_time.
 * Exception is when the structure is used to save the timestamp given by the
 * user on the command line with options -s/-e. In this case, it includes either
 * the number of seconds since the epoch *or* the broken time entered by the user.
 */
struct tstamp_ext {
	unsigned long long epoch_time;
	struct tm tm_time;
	enum time_mode use;
};

/* Structure for items in list */
struct sa_item {
	char *item_name;
	struct sa_item *next;
};

/*
 ***************************************************************************
 * Output formats for sadf
 ***************************************************************************
 */

/* Number of output formats */
#define NR_FMT	9

/* Output formats */
enum {
	F_SAR_OUTPUT	= 0,
	F_DB_OUTPUT	= 1,
	F_HEADER_OUTPUT	= 2,
	F_PPC_OUTPUT	= 3,
	F_XML_OUTPUT	= 4,
	F_JSON_OUTPUT	= 5,
	F_CONV_OUTPUT	= 6,
	F_SVG_OUTPUT	= 7,
	F_RAW_OUTPUT	= 8,
	F_PCP_OUTPUT	= 9
};

/* Structure for SVG specific parameters */
struct svg_parm {
	unsigned long long dt;			/* Interval of time for current sample */
	unsigned long long ust_time_ref;	/* X axis start time in seconds since the epoch */
	unsigned long long ust_time_end;	/* X axis end time in seconds since the epoch */
	unsigned long long ust_time_first;	/* Time (in seconds since the epoch) for first sample */
	int graph_no;				/* Total number of views already displayed */
	int restart;				/* TRUE if we have just met a RESTART record */
	int nr_act_dispd;			/* Number of activities that will be displayed */
	char hour;				/* Hour, minute and second (expressed in the */
	char minute;				/* locale of the datafile creator) for first */
	char second;				/* sample */
	struct file_header *file_hdr;		/* Pointer on file header structure */
	char my_tzname[TZNAME_LEN];		/* Current timezone */
};

/* Structure used when displaying SVG header */
struct svg_hdr_parm {
	int graph_nr;	   /* Number of rows of views to display or canvas height entered on the command line */
	int views_per_row; /* Maximum number of views on a single row */
	int nr_act_dispd;  /* Number of activities that will be displayed */
};

/*
 ***************************************************************************
 * System activity data files
 *
 * The rule is: "strict writing, read any", meaning that sar/sadc can
 * only append data to a datafile whose format is strictly the same as that
 * of current version (checking FORMAT_MAGIC is not enough), but sar/sadf
 * can read data from different versions, providing that FORMAT_MAGIC value
 * has not changed (note that we are talking here of data read from a file,
 * not data that sar reads from sadc, in which case the "strict" rule applies).
 *
 * Format of system activity data files:
 *	 __
 *	|
 *	| file_magic structure
 *	|
 * 	|--
 *	|
 * 	| file_header structure
 * 	|
 * 	|--                         --|
 * 	|                             |
 * 	| file_activity structure     | x file_header:sa_act_nr
 * 	|                             |
 * 	|---------                  --|
 *		|
 * 		| extra_desc structure (exists only if file_header:extra_next != 0)
 * 		|
 * 		|--                         --|
 *		|                             |
 * 		| unknown extra structure(s)  | x extra_desc:extra_nr
 * 		|                             |
 * 		|--                         --|
 *		|
 * 		| (extra_desc structure (exists only if previous extra_desc:extra_next != 0))
 * 		|
 * 		|--
 *		|
 * 		| (...)
 * 		|
 * 	|---------                  --|
 * 	|                             |
 * 	| record_header structure     |
 * 	|                             |
 * 	|---------                  --|
 *		|
 * 		| extra_desc structure (exists only if record_header:extra_next != 0)
 * 		|
 * 		|--                         --|
 *		|                             |
 * 		| unknown extra structure(s)  | x extra_desc:extra_nr
 * 		|                             |
 * 		|--                         --|
 *		|
 * 		| (extra_desc structure (exists only if previous extra_desc:extra_next != 0))
 * 		|
 * 		|--
 *		|
 * 		| (...)
 * 		|
 * 	|---------                  --|
 * 	|(__nr_t)                     |
 * 	|--                           |
 * 	|                             |
 * 	| Statistics structure(s)     | x <count>
 * 	|                             |
 * 	|--                           |
 * 	|(__nr_t)                     |
 * 	|--                           |
 * 	|                             |
 * 	| Statistics structure(s)...  |
 * 	|                             |
 * 	|--                         --|
 *
 * Note: For activities with varying number of items, a __nr_t value, giving
 * the number of items, arrives before the statistics structures so that
 * we know how many of them have to be read.
 * NB: This value exists for all the activities even if they share the same
 * count function (e.g. A_NET_DEV and A_NET_EDEV). Indeed, statistics are not
 * read atomically and the number of items (e.g. network interfaces) may have
 * varied in between.
 *
 * If the record header's type is R_COMMENT then we find only a comment
 * following the record_header structure.
 *
 * If the record_header's type is R_RESTART then we find only the number of CPU
 * (of type __nr_t) of the machine following the record_header structure.
 * This number is 1 for 1 CPU and not an SMP kernel (CPU "all"),
 * 2 for 1 CPU and SMP kernel (CPU "all" and CPU 0), etc.
 * Of course we display the real number of CPU (e.g. "1" for 1 CPU and SMP
 * kernel) with the LINUX RESTART message.
 *
 * If the record_header's type is R_EXTRA* then we find only a list of extra
 * structures following the record_header structure but no statistics ones.
 * Note that extra structures may exist for all record_header types
 * (R_STATS, R_COMMENT, R_RESTART...). For R_COMMENT and R_RESTART records,
 * the extra structures will be found after the comment or the number of CPU.
 ***************************************************************************
 */

/*
 * Sysstat magic number. Should never be modified.
 * Indicate that the file was created by sysstat.
 */
#define SYSSTAT_MAGIC	0xd596
#define SYSSTAT_MAGIC_SWAPPED	(((SYSSTAT_MAGIC << 8) | (SYSSTAT_MAGIC >> 8)) & 0xffff)

/*
 * Datafile format magic number.
 * Modified to indicate that the format of the file is
 * no longer compatible with that of previous sysstat versions.
 */
#define FORMAT_MAGIC	0x2175
#define FORMAT_MAGIC_SWAPPED	(((FORMAT_MAGIC << 8) | (FORMAT_MAGIC >> 8)) & 0xffff)

/* Previous datafile format magic numbers used by older sysstat versions */
#define FORMAT_MAGIC_2171		0x2171
#define FORMAT_MAGIC_2171_SWAPPED	(((FORMAT_MAGIC_2171 << 8) | (FORMAT_MAGIC_2171 >> 8)) & 0xffff)
#define FORMAT_MAGIC_2173		0x2173
#define FORMAT_MAGIC_2173_SWAPPED	(((FORMAT_MAGIC_2173 << 8) | (FORMAT_MAGIC_2173 >> 8)) & 0xffff)

/* Padding in file_magic structure. See below. */
#define FILE_MAGIC_PADDING	48

/* Structure for file magic header data */
struct file_magic {
	/*
	 * This field identifies the file as a file created by sysstat.
	 */
	unsigned short sysstat_magic;
	/*
	 * The value of this field varies whenever datafile format changes.
	 */
	unsigned short format_magic;
	/*
	 * Sysstat version used to create the file.
	 */
	unsigned char sysstat_version;
	unsigned char sysstat_patchlevel;
	unsigned char sysstat_sublevel;
	unsigned char sysstat_extraversion;
#define FILE_MAGIC_ULL_NR	0	/* Nr of unsigned long long below */
#define FILE_MAGIC_UL_NR	0	/* Nr of unsigned long below */
#define FILE_MAGIC_U_NR		5	/* Nr of [unsigned] int below */
	/*
	 * Size of file's header (size of file_header structure used by file).
	 */
	unsigned int header_size;
	/*
	 * Set to non zero if data file has been converted with "sadf -c" from
	 * an old format (version x.y.z) to a newest format (version X.Y.Z).
	 * In this case, the value is: Y*256 + Z + 1.
	 * The FORMAT_MAGIC value of the file can be used to determine X.
	 */
	unsigned int upgraded;
	/*
	 * Description of the file_header structure
	 * (nr of "long long", nr of "long" and nr of "int").
	 */
	unsigned int hdr_types_nr[3];
	/*
	 * Padding. Reserved for future use while avoiding a format change.
	 * sysstat always reads a number of bytes which is that expected for
	 * current sysstat version (FILE_MAGIC_SIZE). We cannot guess if we
	 * are going to read a file from current, an older or a newer version.
	 */
	unsigned char pad[FILE_MAGIC_PADDING];
};

#define FILE_MAGIC_SIZE	(sizeof(struct file_magic))

/* Header structure for system activity data file */
struct file_header {
	/*
	 * Timestamp in seconds since the epoch.
	 */
	unsigned long long sa_ust_time;
	/*
	 * Number of jiffies per second.
	 */
	unsigned long sa_hz		__attribute__ ((aligned (8)));
	/*
	 * Number of [online or offline] CPU (1 .. CPU_NR + 1)
	 * when the datafile has been created.
	 * When reading a datafile, this value is updated (in memory)
	 * whenever a RESTART record is found.
	 * When writing or appending data to a file, this field is updated
	 * neither in file nor in memory.
	 */
	unsigned int sa_cpu_nr		__attribute__ ((aligned (8)));
	/*
	 * Number of activities saved in file.
	 */
	unsigned int sa_act_nr;
	/*
	 * Current year.
	 */
	int sa_year;
	/*
	 * Description of the file_activity and record_header structures
	 * (nr of "long long", nr of "long" and nr of "int").
	 */
	unsigned int act_types_nr[3];
	unsigned int rec_types_nr[3];
	/*
	 * Size of file_activity and record_header structures used by file.
	 */
	unsigned int act_size;
	unsigned int rec_size;
	/*
	 * TRUE if an extra_desc structure exists.
	 */
	unsigned int extra_next;
	/*
	 * Current day and month.
	 * No need to save DST (Daylight Saving Time) flag, since it is not taken
	 * into account by the strftime() function used to print the timestamp.
	 */
	unsigned char sa_day;
	unsigned char sa_month;
	/*
	 * Size of a long integer. Useful to know the architecture on which
	 * the datafile was created.
	 */
	char sa_sizeof_long;
	/*
	 * Operating system name.
	 */
	char sa_sysname[UTSNAME_LEN];
	/*
	 * Machine hostname.
	 */
	char sa_nodename[UTSNAME_LEN];
	/*
	 * Operating system release number.
	 */
	char sa_release[UTSNAME_LEN];
	/*
	 * Machine architecture.
	 */
	char sa_machine[UTSNAME_LEN];
	/*
	 * Timezone value.
	 */
	char sa_tzname[TZNAME_LEN];
};

#define FILE_HEADER_SIZE	(sizeof(struct file_header))
#define FILE_HEADER_ULL_NR	1	/* Nr of unsigned long long in file_header structure */
#define FILE_HEADER_UL_NR	1	/* Nr of unsigned long in file_header structure */
#define FILE_HEADER_U_NR	12	/* Nr of [unsigned] int in file_header structure */
/* The values below are used for sanity check */
#define MIN_FILE_HEADER_SIZE	0
#define MAX_FILE_HEADER_SIZE	8192


/*
 * Base magical number for activities.
 */
#define ACTIVITY_MAGIC_BASE	0x8a

/* List of activities saved in file */
struct file_activity {
	/*
	 * Identification value of activity.
	 */
	unsigned int id;
	/*
	 * Activity magical number.
	 */
	unsigned int magic;
	/*
	 * Number of items for this activity
	 * when the data file has been created.
	 */
	__nr_t nr;
	/*
	 * Number of sub-items for this activity.
	 */
	__nr_t nr2;
	/*
	 * Set to TRUE if statistics are preceded by
	 * a value giving the number of structures to read.
	 */
	int has_nr;
	/*
	 * Size of an item structure.
	 */
	int size;
	/*
	 * Description of the structure containing statistics for the
	 * given activity (nr of "long long", nr of "long" and nr of "int").
	 */
	unsigned int types_nr[3];
};

#define FILE_ACTIVITY_SIZE	(sizeof(struct file_activity))
#define MAX_FILE_ACTIVITY_SIZE	1024	/* Used for sanity check */
#define FILE_ACTIVITY_ULL_NR	0	/* Nr of unsigned long long in file_activity structure */
#define FILE_ACTIVITY_UL_NR	0	/* Nr of unsigned long in file_activity structure */
#define FILE_ACTIVITY_U_NR	9	/* Nr of [unsigned] int in file_activity structure */

#define MAX_ITEM_STRUCT_SIZE	1024	/* Used for sanity check */

/*
 * Description of an extra structure.
 * The composition of this structure should not change in time.
 */
struct extra_desc {
	/*
	 * Number of extra structures to read.
	 */
	unsigned int extra_nr;
	/*
	 * Size of an extra structure.
	 */
	unsigned int extra_size;
	/*
	 * TRUE if another extra_desc structure exists after
	 * all the extra structures.
	 */
	unsigned int extra_next;
	/*
	 * Description of an extra structure
	 * (nr of "long long", nr of "long" and nr of "int").
	 */
	unsigned int extra_types_nr[3];
};

#define EXTRA_DESC_SIZE		(sizeof(struct extra_desc))
#define EXTRA_DESC_ULL_NR	0	/* Nr of unsigned long long in extra_desc structure */
#define EXTRA_DESC_UL_NR	0	/* Nr of unsigned long in extra_desc structure */
#define EXTRA_DESC_U_NR		6	/* Nr of [unsigned] int in extra_desc structure */
#define MAX_EXTRA_NR		8192
#define MAX_EXTRA_SIZE		1024

/* Record type */
enum {
	/*
	 * R_STATS means that this is a record of statistics.
	*/
	R_STATS		= 1,
	/*
	 * R_RESTART means that this is a special record containing
	 * a LINUX RESTART message.
	*/
	R_RESTART	= 2,
	/*
	 * R_LAST_STATS warns sar that this is the last record to be written
	 * to file before a file rotation, and that the next data to come will
	 * be a header file.
	 * Such a record is tagged R_STATS anyway before being written to file.
	 */
	R_LAST_STATS	= 3,
	/*
	 * R_COMMENT means that this is a special record containing
	 * a comment.
	 */
	R_COMMENT	= 4,
	/*
	 * R_EXTRA* records means that extra structures are following current
	 * record_header structure, but no statistics structures.
	*/
	R_EXTRA_MIN	= 5,
	R_EXTRA_MAX	= 15
};

/* Maximum length of a comment */
#define MAX_COMMENT_LEN	64

/* Header structure for every record */
struct record_header {
	/*
	 * Machine uptime in 1/100th of a second.
	 */
	unsigned long long uptime_cs;
	/*
	 * Timestamp (number of seconds since the epoch).
	 */
	unsigned long long ust_time;
	/*
	 * TRUE if an extra_desc structure exists.
	 */
	unsigned int extra_next;
	/*
	 * Record type: R_STATS, R_RESTART,...
	 */
	unsigned char record_type;
	/*
	 * Timestamp: Hour (0-23), minute (0-59) and second (0-60).
	 * Used to determine TRUE time.
	 * Hour value depends in fact on timezone (TZ variable) value.
	 */
	unsigned char hour;
	unsigned char minute;
	unsigned char second;
};

#define RECORD_HEADER_SIZE	(sizeof(struct record_header))
#define MAX_RECORD_HEADER_SIZE	512	/* Used for sanity check */
#define RECORD_HEADER_ULL_NR	2	/* Nr of unsigned long long in record_header structure */
#define RECORD_HEADER_UL_NR	0	/* Nr of unsigned long in record_header structure */
#define RECORD_HEADER_U_NR	1	/* Nr of unsigned int in record_header structure */


/*
 ***************************************************************************
 * Generic description of an activity.
 ***************************************************************************
 */

/* Activity options */
#define AO_NULL			0x00
/*
 * Indicate that corresponding activity should be collected by sadc.
 */
#define AO_COLLECTED		0x01
/*
 * Indicate that corresponding activity should be displayed by sar.
 */
#define AO_SELECTED		0x02
/*
 * Indicate that corresponding activity has items that need to be counted.
 * This means that its @f_count_index values is >= 0.
 * (We use AO_COUNTED instead of @f_count_index because @f_count_index
 * is available (initialized) only for sadc).
 */
#define AO_COUNTED		0x04
/*
 * Indicate that activity's metrics have persistent values when devices
 * are registered again (this means that when the device is registered again,
 * the metrics pick the values they had when they had been unregistered).
 * Exclusively used for CPU related statistics at the present time
 * (e.g. A_CPU and A_NET_SOFT).
 */
#define AO_PERSISTENT		0x08
/*
 * This flag should be set for every activity closing a markup used
 * by several activities. Used by sadf f_xml_print() functions to
 * display XML output, and also by f_json_print() functions to display JSON output.
 */
#define AO_CLOSE_MARKUP		0x10
/*
 * Indicate that corresponding activity has multiple different
 * output formats. This is the case for example for memory activity
 * with options -r and -R.
 * PS: Such an activity should appear in the list of activities that
 * sar -A is supposed to display.
 */
#define AO_MULTIPLE_OUTPUTS	0x20
/*
 * Indicate that one (SVG) graph will be displayed for each
 * distinct item for this activity (sadf -g).
 */
#define AO_GRAPH_PER_ITEM	0x40
/*
 * Indicate that this activity may have sub-items.
 */
#define AO_MATRIX		0x80
/*
 * Indicate that a list of devices has been entered on the command
 * line for this activity (see options --dev=, --iface=, ...)
 */
#define AO_LIST_ON_CMDLINE	0x100
/*
 * Indicate that the number of items for this activity should always
 * be counted, even if the activity is not collected.
 */
#define AO_ALWAYS_COUNTED	0x200
/*
 * Indicate that corresponding activity should be collected only
 * if a test has been successfully passed before.
 * The test corresponds to the count() function (see @f_count_index).
 * This is intended for activities with a fixed number of items but
 * whose {/proc|/sys} files are not necessarily available, e.g. depending
 * on the kernel version used. Unlike activities with AO_COUNTED flag,
 * those having AO_DETECTED flag won't have a @has_nr number preceding
 * their statistics structures in datafile.
 */
#define AO_DETECTED		0x400

#define IS_COLLECTED(m)		(((m) & AO_COLLECTED)        == AO_COLLECTED)
#define IS_SELECTED(m)		(((m) & AO_SELECTED)         == AO_SELECTED)
#define HAS_COUNT_FUNCTION(m)	(((m) & AO_COUNTED)          == AO_COUNTED)
#define HAS_DETECT_FUNCTION(m)	(((m) & AO_DETECTED)         == AO_DETECTED)
#define HAS_PERSISTENT_VALUES(m) (((m) & AO_PERSISTENT)      == AO_PERSISTENT)
#define CLOSE_MARKUP(m)		(((m) & AO_CLOSE_MARKUP)     == AO_CLOSE_MARKUP)
#define HAS_MULTIPLE_OUTPUTS(m)	(((m) & AO_MULTIPLE_OUTPUTS) == AO_MULTIPLE_OUTPUTS)
#define ONE_GRAPH_PER_ITEM(m)	(((m) & AO_GRAPH_PER_ITEM)   == AO_GRAPH_PER_ITEM)
#define IS_MATRIX(m)		(((m) & AO_MATRIX)           == AO_MATRIX)
#define HAS_LIST_ON_CMDLINE(m)	(((m) & AO_LIST_ON_CMDLINE)  == AO_LIST_ON_CMDLINE)
#define ALWAYS_COUNT_ITEMS(m)	(((m) & AO_ALWAYS_COUNTED)   == AO_ALWAYS_COUNTED)

#define _buf0	buf[0]
#define _nr0	nr[0]

/* Structure used to define a bitmap needed by an activity */
struct act_bitmap {
	/*
	 * Bitmap for activities that need one. Remember to allocate it
	 * before use!
	 */
	unsigned char *b_array;
	/*
	 * Size of the bitmap in bits. In fact, bitmap is sized to b_size + 1
	 * to take into account CPU "all"
	 */
	int b_size;
};

/*
 * Structure used to define an activity.
 * Note: This structure can be modified without changing the format of data files.
 */
struct activity {
	/*
	 * This variable contains the identification value (A_...) for this activity.
	 */
	unsigned int id;
	/*
	 * Activity options (AO_...)
	 */
	unsigned int options;
	/*
	 * Activity magical number. This number changes when activity format in file
	 * is no longer compatible with the format of that same activity from
	 * previous versions.
	 */
	unsigned int magic;
	/*
	 * An activity belongs to a group (and only one).
	 * Groups are those selected with option -S of sadc.
	 */
	unsigned int group;
	/*
	 * Index in f_count[] array to determine function used to count
	 * the number of items (serial lines, network interfaces, etc.) for
	 * activities with AO_COUNTED flag. Determine @nr value.
	 * Such a function should _always_ return a value greater than
	 * or equal to 0.
	 *
	 * A value of -1 indicates that the number of items
	 * is a constant (and @nr_ini is set to this value).
	 *
	 * This function may be called even if corresponding activity has not
	 * been selected if flag AO_ALWAYS_COUNTED is set, to make sure that
	 * all items have been calculated (e.g. #CPU)
	 *
	 * The count() function may also be used to know if an activity (with
	 * AO_DETECTED flag) can actually be collected based on the presence of
	 * {/proc|/sys} files.
	 */
	int f_count_index;
	/*
	 * Index in f_count[] array to determine function used to count the
	 * number of sub-items -> @nr2
	 * Such a function should _always_ return a value greater than
	 * or equal to 0.
	 *
	 * A value of -1 indicates that the number of items is a constant
	 * (and @nr2 is set to this value).
	 */
	int f_count2_index;
	/*
	 * This function reads the relevant file and fill the buffer
	 * with statistics corresponding to given activity.
	 */
	__read_funct_t (*f_read) (struct activity *);
	/*
	 * This function displays activity statistics onto the screen.
	 */
	__print_funct_t (*f_print) (struct activity *, int, int, unsigned long long);
	/*
	 * This function displays average activity statistics onto the screen.
	 */
	__print_funct_t (*f_print_avg) (struct activity *, int, int, unsigned long long);
	/*
	 * This function is used by sadf to display activity in a format that can
	 * easily be ingested by a relational database, or a format that can be
	 * handled by pattern processing commands like "awk".
	 */
	__print_funct_t (*f_render) (struct activity *, int, char *, int, unsigned long long);
	/*
	 * This function is used by sadf to display activity statistics in XML.
	 */
	__print_funct_t (*f_xml_print) (struct activity *, int, int, unsigned long long);
	/*
	 * This function is used by sadf to display activity statistics in JSON.
	 */
	__print_funct_t (*f_json_print) (struct activity *, int, int, unsigned long long);
	/*
	 * This function is used by sadf to display activity statistics in SVG.
	 */
	__print_funct_t (*f_svg_print) (struct activity *, int, int, struct svg_parm *,
					unsigned long long, struct record_header *);
	/*
	 * This function is used by sadf to display activity statistics in raw format.
	 */
	__print_funct_t (*f_raw_print) (struct activity *, char *, int);
	/*
	 * This function is used by sadf to display activity statistics in PCP format.
	 */
	__print_funct_t (*f_pcp_print) (struct activity *, int);
	/*
	 * This function is used by sadf to count the number of new items in current
	 * sample and add them to the linked list @item_list.
	 */
	__nr_t (*f_count_new) (struct activity *, int);
	/*
	 * Linked list containing item names. This is either all the different items
	 * found in a file for activities that have a @f_count_new() function (used by sadf),
	 * or a list entered on the command line (used by sadf and sar).
	 */
	struct sa_item *item_list;
	/*
	 * Number of different items found in file (calculated by sadf).
	 * This is also the number of items in @item_list if this list exists.
	 */
	__nr_t item_list_sz;
	/*
	 * Header string displayed by sadf -d.
	 * Header lines for each output (for activities with multiple outputs) are
	 * separated with a '|' character.
	 * For a given output, the first field corresponding to extended statistics
	 * (eg. -r ALL) begins with a '&' character.
	 * A field having '*' in its name means that all items will have its own column
	 * (the first one will be displayed as "all", the following ones will get the '*'
	 * character replaced with their item number (0, 1, etc.)
	 */
	char *hdr_line;
	/*
	 * Description of activity.
	 */
	char *desc;
	/*
	 * Name of activity.
	 */
	char *name;
	/*
	 * Description of the corresponding structure containing statistics (as defined
	 * in rd_stats.h or rd_sensors.h). Such a structure has 0+ fields of type
	 * "long long", followed by 0+ fields of type "long", followed by 0+ fields of
	 * type "int", followed by 0+ other fields (e.g. of type char). The array below
	 * gives the number of "long long" fields composing the structure, then the number
	 * of "long" fields, then the number of "int" fields.
	 */
	unsigned int gtypes_nr[3];
	/*
	 * This array has the same meaning as @gtypes_nr[] above, but the values are those
	 * read from current data file. They may be different from those of @gtypes_nr[]
	 * because we can read data from a different sysstat version (older or newer).
	 */
	unsigned int ftypes_nr[3];
	/*
	 * Number of SVG graphs for this activity. The total number of graphs for
	 * the activity can be greater though if flag AO_GRAPH_PER_ITEM is set, in
	 * which case the total number will  be @g_nr * @nr.
	 */
	int g_nr;
	/*
	 * Number of items on the system, as counted when the system is initialized.
	 * A negative value (-1) is the default value and indicates that this number
	 * has still not been calculated by the function whose index is in @f_count_index.
	 * A value of 0 means that this number has been calculated, but no items have
	 * been found.
	 * A positive value (>0) has either been calculated or is a constant.
	 */
	__nr_t nr_ini;
	/*
	 * Number of sub-items on the system.
	 * @nr2 is in fact the second dimension of a matrix of items, the first
	 * one being @nr. @nr is the number of lines, and @nr2 the number of columns.
	 * A negative value (-1) is the default value and indicates that this number
	 * has still not been calculated by the f_count2() function.
	 * A value of 0 means that this number has been calculated, but no sub-items have
	 * been found.
	 * A positive value (>0) has either been calculated or is a constant.
	 * Rules:
	 * 1) IF @nr2 = 0 THEN @nr_ini = 0
	 *    Note: If @nr_ini = 0, then @nr2 is undetermined (may be -1, 0 or >0).
	 * 2) IF @nr_ini > 0 THEN @nr2 > 0.
	 *    Note: If @nr2 > 0 then @nr_ini is undetermined (may be -1, 0 or >0).
	 * 3) IF @nr_ini <= 0 THEN @nr2 = -1 (this is the default value for @nr2,
	 * meaning that it has not been calculated).
	 */
	__nr_t nr2;
	/*
	 * Maximum number of elements that sar can handle for this item.
	 * NB: The maximum number of elements that sar can handle for sub-items
	 * is NR2_MAX.
	 */
	__nr_t nr_max;
	/*
	 * Number of items, as read and saved in corresponding buffer (@buf: See below).
	 * The value may be zero for a particular sample if no items have been found.
	 */
	__nr_t nr[3];
	/*
	 * Number of structures allocated in @buf[*]. This number should be greater
	 * than or equal to @nr[*].
	 * This also is the number of entries allocated for @spmin and @spmax. An entry
	 * can contain several min or max values.
	 */
	__nr_t nr_allocated;
	/*
	 * Number of min and max values that will be saved for each item.
	 * This will be used to size @spmin / @spmax areas (see below).
	 */
	int xnr;
	/*
	 * Size of an item.
	 * This is the size of the corresponding structure, as read from or written
	 * to a file, or read from or written by the data collector.
	 */
	int fsize;
	/*
	 * Size of an item.
	 * This is the size of the corresponding structure as mapped into memory.
	 * @msize can be different from @fsize when data are read from or written to
	 * a data file from a different sysstat version.
	 */
	int msize;
	/*
	 * Optional flags for activity. This is eg. used when AO_MULTIPLE_OUTPUTS
	 * option is set.
	 * 0x0001 - 0x0080 : Multiple outputs (eg. AO_F_MEMORY, AO_F_SWAP...)
	 * 0x0100 - 0x8000 : If bit set then display complete header (@hdr_line) for
	 *                   corresponding output
	 * 0x010000+       : Optional flags
	 */
	unsigned int opt_flags;
	/*
	 * Buffers that will contain the statistics read. Its size is @nr * @nr2 * @size each.
	 * [0]: used by sadc.
	 * [0] and [1]: current/previous statistics values (used by sar).
	 * [2]: Used by sar to save first collected stats (used later to
	 * compute average).
	 */
	void *buf[3];
	/*
	 * Pointer on area where minimum and maximum values will be saved.
	 * The size of each area is @nr * @nr2 * @xnr * sizeof(double).
	 */
	double *spmin;
	double *spmax;
	/*
	 * Number of slots allocated in @spmin and @spmax buffers.
	 * A slot can contain several values.
	 * This number of slots is always greater than or equal to @nr_allocated.
	 */
	__nr_t nr_spalloc;
	/*
	 * Linked list containing the name of the devices in the order in which their
	 * min and max values have been saved in @spmin and @spmax.
	 */
	struct sa_item *xdev_list;
	/*
	 * Bitmap for activities that need one. Such a bitmap is needed by activity
	 * if @bitmap is not NULL.
	 */
	struct act_bitmap *bitmap;
};


/*
 ***************************************************************************
 * Generic description of an output format for sadf (and sar).
 ***************************************************************************
 */

/* Type for all functions used by sadf to display stats in various formats */
#define __printf_funct_t void
#define __tm_funct_t char *

/*
 * Structure used to define a report.
 * A XML-like report has the following format:
 *       __
 *      |
 *      | Header block
 *      |  __
 *      | |
 *      | | Statistics block
 *      | |  __
 *      | | |
 *      | | | Timestamp block
 *      | | |  __
 *      | | | |
 *      | | | | Activity #1
 *      | | | |__
 *      | | | |
 *      | | | | ...
 *      | | | |__
 *      | | | |
 *      | | | | Activity #n
 *      | | | |__
 *      | | |__
 *      | |__
 *      | |
 *      | | Restart messages block
 *      | |__
 *      | |
 *      | | Comments block
 *      | |__
 *      |__
 */
struct report_format {
	/*
	 * This variable contains the identification value (F_...) for this report format.
	 */
	unsigned int id;
	/*
	 * Format options (FO_...).
	 */
	unsigned int options;
	/*
	 * This function displays the report header
	 * (data displayed once at the beginning of the report).
	 */
	__printf_funct_t (*f_header) (void *, int, char *, char *, struct file_magic *,
				      struct file_header *, struct activity * [], unsigned int [],
				      struct file_activity *);
	/*
	 * This function defines the statistics part of the report.
	 * Used only with textual (XML-like) reports and PCP archives.
	 */
	__printf_funct_t (*f_statistics) (int *, int, struct activity * [], unsigned int []);
	/*
	 * This function defines the timestamp part of the report.
	 * Used only with textual (XML-like) reports, PCP archives and RAW output format.
	 */
	__tm_funct_t (*f_timestamp) (void *, int, char *, char *, char *, unsigned long long,
				     struct record_header *, struct file_header *, unsigned int);
	/*
	 * This function displays the restart messages.
	 */
	__printf_funct_t (*f_restart) (int *, int, char *, char *, char *,
				       struct file_header *, struct record_header *);
	/*
	 * This function displays the comments.
	 */
	__printf_funct_t (*f_comment) (int *, int, char *, char *, char *, char *,
				       struct file_header *, struct record_header *);
	/*
	 * This is the main function used to display all the statistics for current format.
	 */
	void (*f_display) (int, char *, struct file_activity *, struct file_magic *,
			   struct tstamp_ext *, void *);
};


/* Possible actions for functions used to display reports */
#define F_BEGIN	0x01
#define F_MAIN	0x02
#define F_END	0x04

/*
 ***************************************************************************
 * SVG output definitions
 ***************************************************************************
 */

/*
 *   ^
 * 1 | General header
 *   v
 *   ^
 * 9 | One line from table of contents (if any)
 *   v
 *   ^   ^   ^
 *   |   | 4 | Graph title
 *   |   |   v
 *   |   |   ^    |                                Caption
 *   | 3 |   |    |
 *   |   |   |  G |Y
 * 2 |   | 5 |  r |
 *   |   |   |  a |A
 *   |   |   |  d |x
 *   |   |   |  . |i
 *   |   |   |    |s          X Axis
 *   |   |   v    |-------------------------------
 *   |   |              Grad.
 *   |   v   <---><------------------------------>
 *   |         6                8
 *   | Gap
 *   v<---------------------------------------------------------------> Gap
 *                                    7
 *    <--------------------------------------------------------------------->
 *                                      8
 */

/* #8 */
#define SVG_G_XSIZE	720
/* #6 */
#define SVG_M_XSIZE	70
/* #7 */
#define SVG_V_XSIZE	1050
/* #8 */
#define SVG_T_XSIZE	1060

/* #5 */
#define SVG_G_YSIZE	200
/* #1 */
#define SVG_H_YSIZE	60
/* #4 */
#define SVG_M_YSIZE	50
/* #2 */
#define SVG_T_YSIZE	310
/* #3 */
#define SVG_V_YSIZE	300
/* #9 */
#define SVG_C_YSIZE	20

/* Grid: Nr of horizontal lines */
#define SVG_H_GRIDNR	3
/* Grid: Nr of vertical lines */
#define SVG_V_GRIDNR	10

/* Block size used to allocate arrays for graphs data */
#define CHUNKSIZE	4096

/* Maximum number of views on a single row */
#define MAX_VIEWS_ON_A_ROW	6

enum svg_graph_type {
	SVG_LINE_GRAPH 	= 1,
	SVG_BAR_GRAPH	= 2
};

/* Maximum number of horizontal lines for the background grid */
#define MAX_HLINES_NR	10

/* Color palette constants */
#define SVG_COLORS_IDX_MASK	0x0f
#define SVG_COL_PALETTE_SIZE	24
#define SVG_COL_PALETTE_NR	3
#define SVG_COL_BCKGRD_IDX	16
#define SVG_COL_AXIS_IDX	17
#define SVG_COL_GRID_IDX	18
#define SVG_COL_TITLE_IDX	19
#define SVG_COL_INFO_IDX	20
#define SVG_COL_DEFAULT_IDX	21
#define SVG_COL_HEADER_IDX	22
#define SVG_COL_ERROR_IDX	23

enum {
	SVG_DEFAULT_COL_PALETTE	= 0,
	SVG_CUSTOM_COL_PALETTE	= 1,
	SVG_BW_COL_PALETTE	= 2
};

#define MAYBE	0x80

/*
 ***************************************************************************
 * Macro functions definitions.
 *
 * Note: Using 'do ... while' makes the macros safer to use
 * (remember that macro use is followed by a semicolon).
 ***************************************************************************
 */

/* Close file descriptors */
#define CLOSE_ALL(_fd_)		do {			\
					close(_fd_[0]); \
					close(_fd_[1]); \
				} while (0)

#define CLOSE(_fd_)		if (_fd_ >= 0)		\
					close(_fd_)

/*
 ***************************************************************************
 * Functions prototypes.
 ***************************************************************************
 */

/*
 * Prototypes used to count new items
 */
__nr_t count_new_int
	(struct activity *, int);
__nr_t count_new_net_dev
	(struct activity *, int);
__nr_t count_new_net_edev
	(struct activity *, int);
__nr_t count_new_filesystem
	(struct activity *, int);
__nr_t count_new_fchost
	(struct activity *, int);
__nr_t count_new_disk
	(struct activity *, int);
__nr_t count_new_bat
	(struct activity *, int);

/* Functions used to count number of items */
__nr_t wrap_get_cpu_nr
	(struct activity *);
__nr_t wrap_get_irq_nr
	(struct activity *);
__nr_t wrap_get_serial_nr
	(struct activity *);
__nr_t wrap_get_disk_nr
	(struct activity *);
__nr_t wrap_get_iface_nr
	(struct activity *);
__nr_t wrap_get_fan_nr
	(struct activity *);
__nr_t wrap_get_temp_nr
	(struct activity *);
__nr_t wrap_get_in_nr
	(struct activity *);
__nr_t wrap_get_freq_nr
	(struct activity *);
__nr_t wrap_get_usb_nr
	(struct activity *);
__nr_t wrap_get_filesystem_nr
	(struct activity *);
__nr_t wrap_get_fchost_nr
	(struct activity *);
__nr_t wrap_detect_psi
	(struct activity *);
__nr_t wrap_get_bat_nr
	(struct activity *);

/* Functions used to read activities statistics */
__read_funct_t wrap_read_stat_cpu
	(struct activity *);
__read_funct_t wrap_read_stat_pcsw
	(struct activity *);
__read_funct_t wrap_read_stat_irq
	(struct activity *);
__read_funct_t wrap_read_swap
	(struct activity *);
__read_funct_t wrap_read_paging
	(struct activity *);
__read_funct_t wrap_read_io
	(struct activity *);
__read_funct_t wrap_read_meminfo
	(struct activity *);
__read_funct_t wrap_read_kernel_tables
	(struct activity *);
__read_funct_t wrap_read_loadavg
	(struct activity *);
__read_funct_t wrap_read_tty_driver_serial
	(struct activity *);
__read_funct_t wrap_read_disk
	(struct activity *);
__read_funct_t wrap_read_net_dev
	(struct activity *);
__read_funct_t wrap_read_net_edev
	(struct activity *);
__read_funct_t wrap_read_net_nfs
	(struct activity *);
__read_funct_t wrap_read_net_nfsd
	(struct activity *);
__read_funct_t wrap_read_net_sock
	(struct activity *);
__read_funct_t wrap_read_net_ip
	(struct activity *);
__read_funct_t wrap_read_net_eip
	(struct activity *);
__read_funct_t wrap_read_net_icmp
	(struct activity *);
__read_funct_t wrap_read_net_eicmp
	(struct activity *);
__read_funct_t wrap_read_net_tcp
	(struct activity *);
__read_funct_t wrap_read_net_etcp
	(struct activity *);
__read_funct_t wrap_read_net_udp
	(struct activity *);
__read_funct_t wrap_read_net_sock6
	(struct activity *);
__read_funct_t wrap_read_net_ip6
	(struct activity *);
__read_funct_t wrap_read_net_eip6
	(struct activity *);
__read_funct_t wrap_read_net_icmp6
	(struct activity *);
__read_funct_t wrap_read_net_eicmp6
	(struct activity *);
__read_funct_t wrap_read_net_udp6
	(struct activity *);
__read_funct_t wrap_read_cpuinfo
	(struct activity *);
__read_funct_t wrap_read_fan
	(struct activity *);
__read_funct_t wrap_read_temp
	(struct activity *);
__read_funct_t wrap_read_in
	(struct activity *);
__read_funct_t wrap_read_meminfo_huge
	(struct activity *);
__read_funct_t wrap_read_cpu_wghfreq
	(struct activity *);
__read_funct_t wrap_read_bus_usb_dev
	(struct activity *);
__read_funct_t wrap_read_filesystem
	(struct activity *);
__read_funct_t wrap_read_fchost
	(struct activity *);
__read_funct_t wrap_read_softnet
	(struct activity *);
__read_funct_t wrap_read_psicpu
	(struct activity *);
__read_funct_t wrap_read_psiio
	(struct activity *);
__read_funct_t wrap_read_psimem
	(struct activity *);
__read_funct_t wrap_read_bat
	(struct activity *);

/* Other functions */
int check_alt_sa_dir
	(char *, int, int);
void enum_version_nr
	(struct file_magic *);
int get_activity_nr
	(struct activity * [], unsigned int, enum count_mode);
int get_activity_position
	(struct activity * [], unsigned int, int);
void handle_invalid_sa_file
	(int, struct file_magic *, char *, int);
void print_collect_error
	(void);
void set_default_file
	(char *, int, int);
int skip_extra_struct
	(int, int, int);
int write_all
	(int, const void *, int);

#ifndef SOURCE_SADC
int add_list_item
	(struct sa_item **, char *, int, int *);
void allocate_bitmaps
	(struct activity * []);
void allocate_buffers
	(struct activity *, size_t, uint64_t);
void allocate_minmax_buf
	(struct activity *, size_t, uint64_t);
void allocate_structures
	(struct activity * [], uint64_t);
int check_disk_reg
	(struct activity *, int, int, int);
void check_file_actlst
	(int *, char *, struct activity * [], uint64_t, struct file_magic *,
	 struct file_header *, struct file_activity **, unsigned int [], int *, int *);
int check_net_dev_reg
	(struct activity *, int, int, int);
int check_net_edev_reg
	(struct activity *, int, int, int);
int check_time_limits
	(struct tstamp_ext *, struct tstamp_ext *);
double compute_ifutil
	(struct stats_net_dev *, double, double);
void copy_structures
	(struct activity * [], unsigned int [],	struct record_header [], int, int);
int datecmp
	(struct tstamp_ext *, struct tstamp_ext *, int);
void display_sa_file_version
	(FILE *, struct file_magic *);
void free_bitmaps
	(struct activity * []);
void free_structures
	(struct activity * []);
char *get_devname
	(unsigned int, unsigned int);
char *get_sa_devname
	(unsigned int, unsigned int, unsigned long long [], unsigned int, uint64_t);
void get_file_timestamp_struct
	(uint64_t, struct tm *, struct file_header *);
char *get_fs_name_to_display
	(struct activity *, uint64_t, struct stats_filesystem *);
unsigned long long get_global_cpu_statistics
	(struct activity *, int, int, uint64_t, unsigned char []);
void get_global_int_statistics
	(struct activity *, int, int, uint64_t, unsigned char []);
void get_global_soft_statistics
	(struct activity *, int, int, uint64_t, unsigned char []);
void get_itv_value
	(struct record_header *, struct record_header *, unsigned long long *);
void init_custom_color_palette
	(void);
void init_extrema_values
	(struct activity *, int);
int next_slice
	(unsigned long long, unsigned long long, int, long);
void parse_sa_devices
	(char *, struct activity *, int, int *, int, int);
int parse_sar_opt
	(char * [], int *, struct activity * [], uint64_t *, int);
int parse_sa_P_opt
	(char * [], int *, uint64_t *, struct activity * []);
int parse_sar_m_opt
	(char * [], int *, struct activity * []);
int parse_sar_n_opt
	(char * [], int *, struct activity * []);
int parse_sar_q_opt
	(char * [], int *, struct activity * []);
int parse_timestamp
	(char * [], int *, struct tstamp_ext *, const char *, uint64_t);
void print_minmax
	(int);
void print_report_hdr
	(uint64_t, struct tm *, struct file_header *);
void print_sar_comment
	(int *, int, char *, char *, char *, char *, struct file_header *,
	 struct record_header *);
__printf_funct_t print_sar_restart
	(int *, int, char *, char *, char *, struct file_header *, struct record_header *);
int print_special_record
	(struct record_header *, uint64_t, struct tstamp_ext *, struct tstamp_ext *,
	 int, int, struct tstamp_ext *, char *, int, char *, struct file_magic *,
	 struct file_header *, struct activity * [], struct report_format *, int, int);
int read_file_stat_bunch
	(struct activity * [], int, int, int, struct file_activity *, int, int,
	 char *, struct file_magic *, enum on_eof, uint64_t);
__nr_t read_nr_value
	(int, char *, struct file_magic *, int, int, int, __nr_t);
int read_record_hdr
	(int, void *, struct record_header *, struct file_header *, int, int,
	 int, size_t, uint64_t, struct report_format *);
void reallocate_buffers
	(struct activity *, __nr_t, uint64_t);
void reallocate_minmax_buf
	(struct activity *, __nr_t, uint64_t);
void replace_nonprintable_char
	(int, char *);
int sa_fread
	(int, void *, size_t, enum size_mode, enum on_eof);
int sa_get_record_timestamp_struct
	(uint64_t, struct record_header *, struct tstamp_ext *);
int sa_open_read_magic
	(int *, char *, struct file_magic *, int, int *, int);
void save_extrema
	(const unsigned int [], void *, void *, unsigned long long,
	 double *, double *, int []);
void save_minmax
	(struct activity *, int, double);
struct sa_item *search_list_item
	(struct sa_item *, char *);
void select_all_activities
	(struct activity * []);
void select_default_activity
	(struct activity * []);
void set_bitmaps
	(struct activity * [], uint64_t *);
void set_hdr_rectime
	(unsigned int, struct tm *, struct file_header *);
void set_record_timestamp_string
	(uint64_t, char *, char *, int, struct tstamp_ext *);
void swap_struct
	(const unsigned int [], void *, int);
#endif /* SOURCE_SADC undefined */
#endif  /* _SA_H */