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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2004 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _LIBSCF_H
#define _LIBSCF_H
#pragma ident "%Z%%M% %I% %E% SMI"
#include <stddef.h>
#include <sys/types.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef struct scf_version *scf_version_t;
#define SCF_VERSION ((scf_version_t)1UL)
/*
* Opaque structures
*/
typedef struct scf_handle scf_handle_t;
typedef struct scf_scope scf_scope_t;
typedef struct scf_service scf_service_t;
typedef struct scf_instance scf_instance_t;
typedef struct scf_propertygroup scf_propertygroup_t;
typedef struct scf_property scf_property_t;
typedef struct scf_snapshot scf_snapshot_t;
typedef struct scf_snaplevel scf_snaplevel_t;
typedef struct scf_transaction scf_transaction_t;
typedef struct scf_transaction_entry scf_transaction_entry_t;
typedef struct scf_value scf_value_t;
typedef struct scf_iter scf_iter_t;
typedef struct scf_simple_app_props scf_simple_app_props_t;
typedef struct scf_simple_prop scf_simple_prop_t;
/*
* Types
*/
typedef enum {
SCF_TYPE_INVALID = 0,
SCF_TYPE_BOOLEAN,
SCF_TYPE_COUNT,
SCF_TYPE_INTEGER,
SCF_TYPE_TIME,
SCF_TYPE_ASTRING,
SCF_TYPE_OPAQUE,
SCF_TYPE_USTRING = 100,
SCF_TYPE_URI = 200,
SCF_TYPE_FMRI,
SCF_TYPE_HOST = 300,
SCF_TYPE_HOSTNAME,
SCF_TYPE_NET_ADDR_V4,
SCF_TYPE_NET_ADDR_V6
} scf_type_t;
/*
* Return codes
*/
#define SCF_SUCCESS 0
#define SCF_COMPLETE 1
#define SCF_FAILED -1
typedef enum scf_error {
SCF_ERROR_NONE = 1000, /* no error */
SCF_ERROR_NOT_BOUND, /* handle not bound */
SCF_ERROR_NOT_SET, /* cannot use unset argument */
SCF_ERROR_NOT_FOUND, /* nothing of that name found */
SCF_ERROR_TYPE_MISMATCH, /* type does not match value */
SCF_ERROR_IN_USE, /* cannot modify while in-use */
SCF_ERROR_CONNECTION_BROKEN, /* repository connection gone */
SCF_ERROR_INVALID_ARGUMENT, /* bad argument */
SCF_ERROR_NO_MEMORY, /* no memory available */
SCF_ERROR_CONSTRAINT_VIOLATED, /* required constraint not met */
SCF_ERROR_EXISTS, /* object already exists */
SCF_ERROR_NO_SERVER, /* repository server unavailable */
SCF_ERROR_NO_RESOURCES, /* server has insufficient resources */
SCF_ERROR_PERMISSION_DENIED, /* insufficient privileges for action */
SCF_ERROR_BACKEND_ACCESS, /* backend refused access */
SCF_ERROR_HANDLE_MISMATCH, /* mismatched SCF handles */
SCF_ERROR_HANDLE_DESTROYED, /* object bound to destroyed handle */
SCF_ERROR_VERSION_MISMATCH, /* incompatible SCF version */
SCF_ERROR_BACKEND_READONLY, /* backend is read-only */
SCF_ERROR_DELETED, /* object has been deleted */
SCF_ERROR_CALLBACK_FAILED = 1080, /* user callback function failed */
SCF_ERROR_INTERNAL = 1101 /* internal error */
} scf_error_t;
/*
* Standard services
*/
#define SCF_SERVICE_STARTD ((const char *) \
"svc:/system/svc/restarter:default")
#define SCF_SERVICE_CONFIGD ((const char *) \
"svc:/system/svc/repository:default")
/*
* Major milestones
*/
#define SCF_MILESTONE_SINGLE_USER \
((const char *) "svc:/milestone/single-user:default")
#define SCF_MILESTONE_MULTI_USER \
((const char *) "svc:/milestone/multi-user:default")
#define SCF_MILESTONE_MULTI_USER_SERVER \
((const char *) "svc:/milestone/multi-user-server:default")
/*
* standard scope names
*/
#define SCF_SCOPE_LOCAL ((const char *)"localhost")
/*
* Property group types
*/
#define SCF_GROUP_APPLICATION ((const char *)"application")
#define SCF_GROUP_FRAMEWORK ((const char *)"framework")
#define SCF_GROUP_DEPENDENCY ((const char *)"dependency")
#define SCF_GROUP_METHOD ((const char *)"method")
#define SCF_GROUP_TEMPLATE ((const char *)"template")
/*
* Dependency types
*/
#define SCF_DEP_REQUIRE_ALL ((const char *)"require_all")
#define SCF_DEP_REQUIRE_ANY ((const char *)"require_any")
#define SCF_DEP_EXCLUDE_ALL ((const char *)"exclude_all")
#define SCF_DEP_OPTIONAL_ALL ((const char *)"optional_all")
#define SCF_DEP_RESET_ON_ERROR ((const char *)"error")
#define SCF_DEP_RESET_ON_RESTART ((const char *)"restart")
#define SCF_DEP_RESET_ON_REFRESH ((const char *)"refresh")
#define SCF_DEP_RESET_ON_NONE ((const char *)"none")
/*
* Standard property group names
*/
#define SCF_PG_GENERAL ((const char *)"general")
#define SCF_PG_GENERAL_OVR ((const char *)"general_ovr")
#define SCF_PG_RESTARTER ((const char *)"restarter")
#define SCF_PG_RESTARTER_ACTIONS ((const char *)"restarter_actions")
#define SCF_PG_METHOD_CONTEXT ((const char *)"method_context")
#define SCF_PG_APP_DEFAULT ((const char *)"application")
#define SCF_PG_DEPENDENTS ((const char *)"dependents")
#define SCF_PG_OPTIONS ((const char *)"options")
#define SCF_PG_OPTIONS_OVR ((const char *)"options_ovr")
#define SCF_PG_STARTD ((const char *)"startd")
#define SCF_PG_STARTD_PRIVATE ((const char *)"svc-startd-private")
/*
* Template property group names and prefix
*/
#define SCF_PG_TM_COMMON_NAME ((const char *)"tm_common_name")
#define SCF_PG_TM_DESCRIPTION ((const char *)"tm_description")
#define SCF_PG_TM_MAN_PREFIX ((const char *)"tm_man_")
#define SCF_PG_TM_DOC_PREFIX ((const char *)"tm_doc_")
/*
* Standard property names
*/
#define SCF_PROPERTY_AUX_STATE ((const char *)"auxiliary_state")
#define SCF_PROPERTY_CONTRACT ((const char *)"contract")
#define SCF_PROPERTY_COREFILE_PATTERN ((const char *)"corefile_pattern")
#define SCF_PROPERTY_DEGRADED ((const char *)"degraded")
#define SCF_PROPERTY_DEGRADE_IMMEDIATE ((const char *)"degrade_immediate")
#define SCF_PROPERTY_DURATION ((const char *)"duration")
#define SCF_PROPERTY_ENABLED ((const char *)"enabled")
#define SCF_PROPERTY_ENTITY_STABILITY ((const char *)"entity_stability")
#define SCF_PROPERTY_ENTITIES ((const char *)"entities")
#define SCF_PROPERTY_EXEC ((const char *)"exec")
#define SCF_PROPERTY_GROUP ((const char *)"group")
#define SCF_PROPERTY_GROUPING ((const char *)"grouping")
#define SCF_PROPERTY_IGNORE ((const char *)"ignore_error")
#define SCF_PROPERTY_LIMIT_PRIVILEGES ((const char *)"limit_privileges")
#define SCF_PROPERTY_MAINT_OFF ((const char *)"maint_off")
#define SCF_PROPERTY_MAINT_ON ((const char *)"maint_on")
#define SCF_PROPERTY_MAINT_ON_IMMEDIATE ((const char *)"maint_on_immediate")
#define SCF_PROPERTY_MAINT_ON_IMMTEMP ((const char *)"maint_on_immtemp")
#define SCF_PROPERTY_MAINT_ON_TEMPORARY ((const char *)"maint_on_temporary")
#define SCF_PROPERTY_METHOD_PID ((const char *)"method_pid")
#define SCF_PROPERTY_MILESTONE ((const char *)"milestone")
#define SCF_PROPERTY_NEED_SESSION ((const char *)"need_session")
#define SCF_PROPERTY_NEXT_STATE ((const char *)"next_state")
#define SCF_PROPERTY_PACKAGE ((const char *)"package")
#define SCF_PROPERTY_PRIVILEGES ((const char *)"privileges")
#define SCF_PROPERTY_PROFILE ((const char *)"profile")
#define SCF_PROPERTY_PROJECT ((const char *)"project")
#define SCF_PROPERTY_REFRESH ((const char *)"refresh")
#define SCF_PROPERTY_RESOURCE_POOL ((const char *)"resource_pool")
#define SCF_PROPERTY_ENVIRONMENT ((const char *)"environment")
#define SCF_PROPERTY_RESTART ((const char *)"restart")
#define SCF_PROPERTY_RESTARTER ((const char *)"restarter")
#define SCF_PROPERTY_RESTART_INTERVAL ((const char *)"restart_interval")
#define SCF_PROPERTY_RESTART_ON ((const char *)"restart_on")
#define SCF_PROPERTY_RESTORE ((const char *)"restore")
#define SCF_PROPERTY_SINGLE_INSTANCE ((const char *)"single_instance")
#define SCF_PROPERTY_START_METHOD_TIMESTAMP \
((const char *)"start_method_timestamp")
#define SCF_PROPERTY_START_METHOD_WAITSTATUS \
((const char *)"start_method_waitstatus")
#define SCF_PROPERTY_START_PID ((const char *)"start_pid")
#define SCF_PROPERTY_STATE ((const char *)"state")
#define SCF_PROPERTY_STABILITY ((const char *)"stability")
#define SCF_PROPERTY_STATE_TIMESTAMP ((const char *)"state_timestamp")
#define SCF_PROPERTY_SUPP_GROUPS ((const char *)"supp_groups")
#define SCF_PROPERTY_TIMEOUT ((const char *)"timeout_seconds")
#define SCF_PROPERTY_TIMEOUT_RETRY ((const char *)"timeout_retry")
#define SCF_PROPERTY_TRANSIENT_CONTRACT ((const char *)"transient_contract")
#define SCF_PROPERTY_TYPE ((const char *)"type")
#define SCF_PROPERTY_USE_PROFILE ((const char *)"use_profile")
#define SCF_PROPERTY_USER ((const char *)"user")
#define SCF_PROPERTY_UTMPX_PREFIX ((const char *)"utmpx_prefix")
#define SCF_PROPERTY_WORKING_DIRECTORY ((const char *)"working_directory")
/*
* Template property names
*/
#define SCF_PROPERTY_TM_MANPATH ((const char *)"manpath")
#define SCF_PROPERTY_TM_SECTION ((const char *)"section")
#define SCF_PROPERTY_TM_TITLE ((const char *)"title")
#define SCF_PROPERTY_TM_NAME ((const char *)"name")
#define SCF_PROPERTY_TM_URI ((const char *)"uri")
/*
* Strings used by restarters for state and next_state properties.
* MAX_SCF_STATE_STRING holds the max length of a state string, including the
* terminating null.
*/
#define MAX_SCF_STATE_STRING_SZ 14
#define SCF_STATE_STRING_NONE ((const char *)"none")
#define SCF_STATE_STRING_UNINIT ((const char *)"uninitialized")
#define SCF_STATE_STRING_MAINT ((const char *)"maintenance")
#define SCF_STATE_STRING_OFFLINE ((const char *)"offline")
#define SCF_STATE_STRING_DISABLED ((const char *)"disabled")
#define SCF_STATE_STRING_ONLINE ((const char *)"online")
#define SCF_STATE_STRING_DEGRADED ((const char *)"degraded")
#define SCF_STATE_STRING_LEGACY ((const char *)"legacy_run")
#define SCF_STATE_UNINIT 0x00000001
#define SCF_STATE_MAINT 0x00000002
#define SCF_STATE_OFFLINE 0x00000004
#define SCF_STATE_DISABLED 0x00000008
#define SCF_STATE_ONLINE 0x00000010
#define SCF_STATE_DEGRADED 0x00000020
#define SCF_STATE_ALL 0x0000003F
#define SCF_PG_FLAG_NONPERSISTENT 0x1
#define SCF_TRACE_LIBRARY 0x1
#define SCF_TRACE_DAEMON 0x2
#define SMF_IMMEDIATE 0x1
#define SMF_TEMPORARY 0x2
#define SMF_AT_NEXT_BOOT 0x4
scf_error_t scf_error(void);
const char *scf_strerror(scf_error_t);
ssize_t scf_limit(uint32_t code);
#define SCF_LIMIT_MAX_NAME_LENGTH -2000U
#define SCF_LIMIT_MAX_VALUE_LENGTH -2001U
#define SCF_LIMIT_MAX_PG_TYPE_LENGTH -2002U
#define SCF_LIMIT_MAX_FMRI_LENGTH -2003U
scf_handle_t *scf_handle_create(scf_version_t);
int scf_handle_decorate(scf_handle_t *, const char *, scf_value_t *);
#define SCF_DECORATE_CLEAR ((scf_value_t *)0)
int scf_handle_bind(scf_handle_t *);
int scf_handle_unbind(scf_handle_t *);
void scf_handle_destroy(scf_handle_t *);
int scf_type_base_type(scf_type_t type, scf_type_t *out);
/* values */
scf_value_t *scf_value_create(scf_handle_t *);
scf_handle_t *scf_value_handle(const scf_value_t *);
void scf_value_destroy(scf_value_t *);
scf_type_t scf_value_base_type(const scf_value_t *);
scf_type_t scf_value_type(const scf_value_t *);
int scf_value_is_type(const scf_value_t *, scf_type_t);
void scf_value_reset(scf_value_t *);
int scf_value_get_boolean(const scf_value_t *, uint8_t *);
int scf_value_get_count(const scf_value_t *, uint64_t *);
int scf_value_get_integer(const scf_value_t *, int64_t *);
int scf_value_get_time(const scf_value_t *, int64_t *, int32_t *);
ssize_t scf_value_get_astring(const scf_value_t *, char *, size_t);
ssize_t scf_value_get_ustring(const scf_value_t *, char *, size_t);
ssize_t scf_value_get_opaque(const scf_value_t *, void *, size_t);
void scf_value_set_boolean(scf_value_t *, uint8_t);
void scf_value_set_count(scf_value_t *, uint64_t);
void scf_value_set_integer(scf_value_t *, int64_t);
int scf_value_set_time(scf_value_t *, int64_t, int32_t);
int scf_value_set_astring(scf_value_t *, const char *);
int scf_value_set_ustring(scf_value_t *, const char *);
int scf_value_set_opaque(scf_value_t *, const void *, size_t);
ssize_t scf_value_get_as_string(const scf_value_t *, char *, size_t);
ssize_t scf_value_get_as_string_typed(const scf_value_t *, scf_type_t,
char *, size_t);
int scf_value_set_from_string(scf_value_t *, scf_type_t, const char *);
scf_iter_t *scf_iter_create(scf_handle_t *);
scf_handle_t *scf_iter_handle(const scf_iter_t *);
void scf_iter_reset(scf_iter_t *);
void scf_iter_destroy(scf_iter_t *);
int scf_iter_handle_scopes(scf_iter_t *, const scf_handle_t *);
int scf_iter_scope_services(scf_iter_t *, const scf_scope_t *);
int scf_iter_service_instances(scf_iter_t *, const scf_service_t *);
int scf_iter_service_pgs(scf_iter_t *, const scf_service_t *);
int scf_iter_instance_pgs(scf_iter_t *, const scf_instance_t *);
int scf_iter_instance_pgs_composed(scf_iter_t *, const scf_instance_t *,
const scf_snapshot_t *);
int scf_iter_service_pgs_typed(scf_iter_t *, const scf_service_t *,
const char *);
int scf_iter_instance_pgs_typed(scf_iter_t *, const scf_instance_t *,
const char *);
int scf_iter_instance_pgs_typed_composed(scf_iter_t *, const scf_instance_t *,
const scf_snapshot_t *, const char *);
int scf_iter_snaplevel_pgs(scf_iter_t *, const scf_snaplevel_t *);
int scf_iter_snaplevel_pgs_typed(scf_iter_t *, const scf_snaplevel_t *,
const char *);
int scf_iter_instance_snapshots(scf_iter_t *, const scf_instance_t *);
int scf_iter_pg_properties(scf_iter_t *, const scf_propertygroup_t *);
int scf_iter_property_values(scf_iter_t *, const scf_property_t *);
int scf_iter_next_scope(scf_iter_t *, scf_scope_t *);
int scf_iter_next_service(scf_iter_t *, scf_service_t *);
int scf_iter_next_instance(scf_iter_t *, scf_instance_t *);
int scf_iter_next_pg(scf_iter_t *, scf_propertygroup_t *);
int scf_iter_next_property(scf_iter_t *, scf_property_t *);
int scf_iter_next_snapshot(scf_iter_t *, scf_snapshot_t *);
int scf_iter_next_value(scf_iter_t *, scf_value_t *);
scf_scope_t *scf_scope_create(scf_handle_t *);
scf_handle_t *scf_scope_handle(const scf_scope_t *);
/* XXX eventually remove this */
#define scf_handle_get_local_scope(h, s) \
scf_handle_get_scope((h), SCF_SCOPE_LOCAL, (s))
int scf_handle_get_scope(scf_handle_t *, const char *, scf_scope_t *);
void scf_scope_destroy(scf_scope_t *);
ssize_t scf_scope_get_name(const scf_scope_t *, char *, size_t);
ssize_t scf_scope_to_fmri(const scf_scope_t *, char *, size_t);
scf_service_t *scf_service_create(scf_handle_t *);
scf_handle_t *scf_service_handle(const scf_service_t *);
void scf_service_destroy(scf_service_t *);
int scf_scope_get_parent(const scf_scope_t *, scf_scope_t *);
ssize_t scf_service_get_name(const scf_service_t *, char *, size_t);
ssize_t scf_service_to_fmri(const scf_service_t *, char *, size_t);
int scf_service_get_parent(const scf_service_t *, scf_scope_t *);
int scf_scope_get_service(const scf_scope_t *, const char *, scf_service_t *);
int scf_scope_add_service(const scf_scope_t *, const char *, scf_service_t *);
int scf_service_delete(scf_service_t *);
scf_instance_t *scf_instance_create(scf_handle_t *);
scf_handle_t *scf_instance_handle(const scf_instance_t *);
void scf_instance_destroy(scf_instance_t *);
ssize_t scf_instance_get_name(const scf_instance_t *, char *, size_t);
ssize_t scf_instance_to_fmri(const scf_instance_t *, char *, size_t);
int scf_service_get_instance(const scf_service_t *, const char *,
scf_instance_t *);
int scf_service_add_instance(const scf_service_t *, const char *,
scf_instance_t *);
int scf_instance_delete(scf_instance_t *);
scf_snapshot_t *scf_snapshot_create(scf_handle_t *);
scf_handle_t *scf_snapshot_handle(const scf_snapshot_t *);
void scf_snapshot_destroy(scf_snapshot_t *);
ssize_t scf_snapshot_get_name(const scf_snapshot_t *, char *, size_t);
int scf_snapshot_get_parent(const scf_snapshot_t *, scf_instance_t *);
int scf_instance_get_snapshot(const scf_instance_t *, const char *,
scf_snapshot_t *);
int scf_snapshot_update(scf_snapshot_t *);
scf_snaplevel_t *scf_snaplevel_create(scf_handle_t *);
scf_handle_t *scf_snaplevel_handle(const scf_snaplevel_t *);
void scf_snaplevel_destroy(scf_snaplevel_t *);
int scf_snaplevel_get_parent(const scf_snaplevel_t *, scf_snapshot_t *);
ssize_t scf_snaplevel_get_scope_name(const scf_snaplevel_t *, char *, size_t);
ssize_t scf_snaplevel_get_service_name(const scf_snaplevel_t *, char *, size_t);
ssize_t scf_snaplevel_get_instance_name(const scf_snaplevel_t *, char *,
size_t);
int scf_snaplevel_get_pg(const scf_snaplevel_t *, const char *,
scf_propertygroup_t *pg);
int scf_snapshot_get_base_snaplevel(const scf_snapshot_t *, scf_snaplevel_t *);
int scf_snaplevel_get_next_snaplevel(const scf_snaplevel_t *,
scf_snaplevel_t *);
scf_propertygroup_t *scf_pg_create(scf_handle_t *);
scf_handle_t *scf_pg_handle(const scf_propertygroup_t *);
void scf_pg_destroy(scf_propertygroup_t *);
ssize_t scf_pg_to_fmri(const scf_propertygroup_t *, char *, size_t);
ssize_t scf_pg_get_name(const scf_propertygroup_t *, char *, size_t);
ssize_t scf_pg_get_type(const scf_propertygroup_t *, char *, size_t);
int scf_pg_get_flags(const scf_propertygroup_t *, uint32_t *);
int scf_pg_get_parent_service(const scf_propertygroup_t *, scf_service_t *);
int scf_pg_get_parent_instance(const scf_propertygroup_t *, scf_instance_t *);
int scf_pg_get_parent_snaplevel(const scf_propertygroup_t *, scf_snaplevel_t *);
int scf_service_get_pg(const scf_service_t *, const char *,
scf_propertygroup_t *);
int scf_instance_get_pg(const scf_instance_t *, const char *,
scf_propertygroup_t *);
int scf_instance_get_pg_composed(const scf_instance_t *, const scf_snapshot_t *,
const char *, scf_propertygroup_t *);
int scf_service_add_pg(const scf_service_t *, const char *, const char *,
uint32_t, scf_propertygroup_t *);
int scf_instance_add_pg(const scf_instance_t *, const char *, const char *,
uint32_t, scf_propertygroup_t *);
int scf_pg_delete(scf_propertygroup_t *);
int scf_pg_get_underlying_pg(const scf_propertygroup_t *,
scf_propertygroup_t *);
int scf_instance_get_parent(const scf_instance_t *, scf_service_t *);
int scf_pg_update(scf_propertygroup_t *);
scf_property_t *scf_property_create(scf_handle_t *);
scf_handle_t *scf_property_handle(const scf_property_t *);
void scf_property_destroy(scf_property_t *);
int scf_property_is_type(const scf_property_t *, scf_type_t);
int scf_property_type(const scf_property_t *, scf_type_t *);
ssize_t scf_property_get_name(const scf_property_t *, char *, size_t);
int scf_property_get_value(const scf_property_t *, scf_value_t *);
ssize_t scf_property_to_fmri(const scf_property_t *, char *, size_t);
int scf_pg_get_property(const scf_propertygroup_t *, const char *,
scf_property_t *);
scf_transaction_t *scf_transaction_create(scf_handle_t *);
scf_handle_t *scf_transaction_handle(const scf_transaction_t *);
int scf_transaction_start(scf_transaction_t *, scf_propertygroup_t *);
void scf_transaction_destroy(scf_transaction_t *);
void scf_transaction_destroy_children(scf_transaction_t *);
void scf_transaction_reset(scf_transaction_t *);
void scf_transaction_reset_all(scf_transaction_t *);
int scf_transaction_commit(scf_transaction_t *);
scf_transaction_entry_t *scf_entry_create(scf_handle_t *);
scf_handle_t *scf_entry_handle(const scf_transaction_entry_t *);
void scf_entry_reset(scf_transaction_entry_t *);
void scf_entry_destroy(scf_transaction_entry_t *);
void scf_entry_destroy_children(scf_transaction_entry_t *);
int scf_transaction_property_change(scf_transaction_t *,
scf_transaction_entry_t *, const char *, scf_type_t);
int scf_transaction_property_delete(scf_transaction_t *,
scf_transaction_entry_t *, const char *);
int scf_transaction_property_new(scf_transaction_t *,
scf_transaction_entry_t *, const char *, scf_type_t);
int scf_transaction_property_change_type(scf_transaction_t *,
scf_transaction_entry_t *, const char *, scf_type_t);
int scf_entry_add_value(scf_transaction_entry_t *, scf_value_t *);
int scf_handle_decode_fmri(scf_handle_t *, const char *, scf_scope_t *,
scf_service_t *, scf_instance_t *, scf_propertygroup_t *, scf_property_t *,
int);
#define SCF_DECODE_FMRI_EXACT 0x00000001
#define SCF_DECODE_FMRI_TRUNCATE 0x00000002
#define SCF_DECODE_FMRI_REQUIRE_INSTANCE 0x00000004
#define SCF_DECODE_FMRI_REQUIRE_NO_INSTANCE 0x00000008
ssize_t scf_myname(scf_handle_t *, char *, size_t);
/*
* Simplified calls
*/
int smf_enable_instance(const char *, int);
int smf_disable_instance(const char *, int);
int smf_refresh_instance(const char *);
int smf_restart_instance(const char *);
int smf_maintain_instance(const char *, int);
int smf_degrade_instance(const char *, int);
int smf_restore_instance(const char *);
char *smf_get_state(const char *);
int scf_simple_walk_instances(uint_t, void *,
int (*inst_callback)(scf_handle_t *, scf_instance_t *, void *));
scf_simple_prop_t *scf_simple_prop_get(scf_handle_t *, const char *,
const char *, const char *);
void scf_simple_prop_free(scf_simple_prop_t *);
scf_simple_app_props_t *scf_simple_app_props_get(scf_handle_t *, const char *);
void scf_simple_app_props_free(scf_simple_app_props_t *);
const scf_simple_prop_t *scf_simple_app_props_next(
const scf_simple_app_props_t *, scf_simple_prop_t *);
const scf_simple_prop_t *scf_simple_app_props_search(
const scf_simple_app_props_t *, const char *, const char *);
ssize_t scf_simple_prop_numvalues(const scf_simple_prop_t *);
scf_type_t scf_simple_prop_type(const scf_simple_prop_t *);
char *scf_simple_prop_name(const scf_simple_prop_t *);
char *scf_simple_prop_pgname(const scf_simple_prop_t *);
uint8_t *scf_simple_prop_next_boolean(scf_simple_prop_t *);
uint64_t *scf_simple_prop_next_count(scf_simple_prop_t *);
int64_t *scf_simple_prop_next_integer(scf_simple_prop_t *);
int64_t *scf_simple_prop_next_time(scf_simple_prop_t *, int32_t *);
char *scf_simple_prop_next_astring(scf_simple_prop_t *);
char *scf_simple_prop_next_ustring(scf_simple_prop_t *);
void *scf_simple_prop_next_opaque(scf_simple_prop_t *, size_t *);
void scf_simple_prop_next_reset(scf_simple_prop_t *);
/*
* SMF exit status definitions
*/
#define SMF_EXIT_OK 0
#define SMF_EXIT_ERR_FATAL 95
#define SMF_EXIT_ERR_CONFIG 96
#define SMF_EXIT_MON_DEGRADE 97
#define SMF_EXIT_MON_OFFLINE 98
#define SMF_EXIT_ERR_NOSMF 99
#define SMF_EXIT_ERR_PERM 100
#ifdef __cplusplus
}
#endif
#endif /* _LIBSCF_H */
|
