1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
/*
Copyright 2024 Northern.tech AS
This file is part of CFEngine 3 - written and maintained by Northern.tech AS.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; version 3.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
To the extent this program is licensed as part of the Enterprise
versions of CFEngine, the applicable Commercial Open Source License
(COSL) may apply to this file if you as a licensee so wish it. See
included file COSL.txt.
*/
#ifndef CFENGINE_GENERIC_AGENT_H
#define CFENGINE_GENERIC_AGENT_H
#include <cf3.defs.h>
#include <policy.h>
#include <set.h>
#define GENERIC_AGENT_CHECKSUM_SIZE ((2*CF_SHA1_LEN) + 1)
#define GENERIC_AGENT_CHECKSUM_METHOD HASH_METHOD_SHA1
enum generic_agent_config_common_policy_output_format
{
GENERIC_AGENT_CONFIG_COMMON_POLICY_OUTPUT_FORMAT_NONE,
GENERIC_AGENT_CONFIG_COMMON_POLICY_OUTPUT_FORMAT_CF,
GENERIC_AGENT_CONFIG_COMMON_POLICY_OUTPUT_FORMAT_JSON,
GENERIC_AGENT_CONFIG_COMMON_POLICY_OUTPUT_FORMAT_CF_FULL,
GENERIC_AGENT_CONFIG_COMMON_POLICY_OUTPUT_FORMAT_JSON_FULL
};
typedef struct
{
AgentType agent_type;
Rlist *bundlesequence;
char *original_input_file;
char *input_file;
char *input_dir;
char *tag_release_dir;
bool check_not_writable_by_others;
bool check_runnable;
StringSet *heap_soft;
StringSet *heap_negated;
bool ignore_locks;
bool tty_interactive; // agent is running interactively, via tty/terminal interface
bool color;
ProtocolVersion protocol_version;
// agent state
bool ignore_missing_bundles;
bool ignore_missing_inputs;
bool ignore_preferred_augments; // --ignore-preferred-augments
struct
{
struct
{
enum generic_agent_config_common_policy_output_format policy_output_format;
unsigned int parser_warnings;
unsigned int parser_warnings_error;
bool eval_functions;
char *show_classes;
char *show_variables;
bool no_augments;
bool no_host_specific;
} common;
struct
{
char *bootstrap_argument;
char *bootstrap_host;
char *bootstrap_port;
char *bootstrap_ip;
bool bootstrap_trust_server;
bool bootstrap_trigger_policy;
bool skip_bootstrap_service_start;
char *show_evaluated_classes;
char *show_evaluated_variables;
// BODY AGENT CONTROL
bool report_class_log;
} agent;
struct
{
/* Time of the last validated_at timestamp seen. */
time_t last_validated_at;
} daemon; /* execd, serverd etc */
} agent_specific;
} GenericAgentConfig;
ENTERPRISE_VOID_FUNC_2ARG_DECLARE(void, GenericAgentSetDefaultDigest, HashMethod *, digest, int *, digest_len);
const char *GenericAgentResolveInputPath(const GenericAgentConfig *config, const char *input_file);
void MarkAsPolicyServer(EvalContext *ctx);
void GenericAgentDiscoverContext(EvalContext *ctx, GenericAgentConfig *config, const char *program_name);
bool GenericAgentCheckPolicy(GenericAgentConfig *config, bool force_validation, bool write_validated_file);
ENTERPRISE_VOID_FUNC_1ARG_DECLARE(void, GenericAgentAddEditionClasses, EvalContext *, ctx);
void GenericAgentInitialize(EvalContext *ctx, GenericAgentConfig *config);
void GenericAgentFinalize(EvalContext *ctx, GenericAgentConfig *config);
ENTERPRISE_VOID_FUNC_1ARG_DECLARE(void, GenericAgentWriteVersion, Writer *, w);
bool GenericAgentArePromisesValid(const GenericAgentConfig *config);
time_t ReadTimestampFromPolicyValidatedFile(const GenericAgentConfig *config, const char *maybe_dirname);
bool GenericAgentIsPolicyReloadNeeded(const GenericAgentConfig *config);
void CloseLog(void);
Seq *ControlBodyConstraints(const Policy *policy, AgentType agent);
void SetFacility(const char *retval);
void CheckBundleParameters(char *scope, Rlist *args);
void WritePID(char *filename);
pid_t ReadPID(char *filename);
bool GenericAgentConfigParseArguments(GenericAgentConfig *config, int argc, char **argv);
bool GenericAgentConfigParseWarningOptions(GenericAgentConfig *config, const char *warning_options);
bool GenericAgentConfigParseColor(GenericAgentConfig *config, const char *mode);
Policy *SelectAndLoadPolicy(GenericAgentConfig *config, EvalContext *ctx, bool validate_policy, bool write_validated_file);
GenericAgentConfig *GenericAgentConfigNewDefault(AgentType agent_type, bool tty_interactive);
bool GetTTYInteractive(void);
void GenericAgentConfigDestroy(GenericAgentConfig *config);
void GenericAgentConfigApply(EvalContext *ctx, const GenericAgentConfig *config);
bool CheckAndGenerateFailsafe(const char *inputdir, const char *input_file);
void GenericAgentConfigSetInputFile(GenericAgentConfig *config, const char *inputdir, const char *input_file);
void GenericAgentConfigSetBundleSequence(GenericAgentConfig *config, const Rlist *bundlesequence);
bool GenericAgentTagReleaseDirectory(const GenericAgentConfig *config, const char *dirname, bool write_validated, bool write_release);
void GetReleaseIdFile(const char *base_path, char *filename, size_t max_size);
bool GenericAgentPostLoadInit(const EvalContext *ctx);
void SetupSignalsForAgent(void);
void LoadAugments(EvalContext *ctx, GenericAgentConfig *config);
void GenericAgentShowContextsFormatted(EvalContext *ctx, const char *regexp);
void GenericAgentShowVariablesFormatted(EvalContext *ctx, const char *regexp);
#endif
|
