1scf_limit(3SCF)Service Configuration Facility Library Functionsscf_limit(3SCF)
2
3
4

NAME

6       scf_limit - limit information for Service Configuration Facility
7

SYNOPSIS

9       cc [ flag... ] file... -lscf [ library... ]
10       #include <libscf.h>
11
12       ssize_t scf_limit(uint32_t name);
13
14

DESCRIPTION

16       The  scf_limit()  function  returns  information  about implementation-
17       defined limits in the service configuration facility. These limits  are
18       generally  maximum  lengths for various strings. The values returned do
19       not change during the execution of a program, but they  should  not  be
20       cached between executions.
21
22
23       The available values for name are:
24
25       SCF_LIMIT_MAX_FMRI_LENGTH
26
27           Return  the  maximum  length  of  an FMRI the service configuration
28           facility accepts.
29
30
31       SCF_LIMIT_MAX_PG_TYPE_LENGTH
32
33           Return the maximum length for property group types in  the  service
34           configuration facility.
35
36
37       SCF_LIMIT_MAX_NAME_LENGTH
38
39           Return  the  maximum  length for names in the service configuration
40           facility. This value does not include space for the required termi‐
41           nating null byte.
42
43
44       SCF_LIMIT_MAX_VALUE_LENGTH
45
46           Return  the  maximum  string  length  a  scf_value_t  can hold, not
47           including the terminating null byte.
48
49
50
51       Lengths do not include space for the required terminating null byte.
52

RETURN VALUES

54       Upon successful completion, scf_limit() returns  the  requested  value.
55       Otherwise, it returns -1.
56

ERRORS

58       The scf_limit() function will fail if:
59
60       SCF_ERROR_INVALID_ARGUMENT    The  name  argument  is  not a recognized
61                                     request.
62
63
64
65       The scf_error(3SCF) function can be used to retrieve the error value.
66

ATTRIBUTES

68       See attributes(5) for descriptions of the following attributes:
69
70
71
72
73       ┌─────────────────────────────┬─────────────────────────────┐
74       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
75       ├─────────────────────────────┼─────────────────────────────┤
76       │Interface Stability          │Evolving                     │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │MT-Level                     │MT-Safe                      │
79       └─────────────────────────────┴─────────────────────────────┘
80

SEE ALSO

82       libscf(3LIB), scf_error(3SCF), attributes(5)
83
84
85
86SunOS 5.11                        17 Aug 2004                  scf_limit(3SCF)
Impressum