Print this page
9728 3secdb man pages need some tlc
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man3secdb/getprofattr.3secdb.man.txt
+++ new/usr/src/man/man3secdb/getprofattr.3secdb.man.txt
1 1 GETPROFATTR(3SECDB) Security Attributes Database Library Functions
2 2
3 3
4 4
5 5 NAME
6 6 getprofattr, getprofnam, free_profattr, setprofattr, endprofattr,
7 7 getproflist, free_proflist - get profile description and attributes
8 8
9 9 SYNOPSIS
10 10 cc [ flag... ] file... -lsecdb -lsocket -lnsl [ library... ]
11 11 #include <prof_attr.h>
12 12
13 13 profattr_t *getprofattr(void);
14 14
15 15
16 16 profattr_t *getprofnam(const char *name);
17 17
18 18
19 19 void free_profattr(profattr_t *pd);
20 20
21 21
22 22 void setprofattr(void);
23 23
24 24
25 25 void endprofattr(void);
26 26
27 27
28 28 void getproflist(const char *profname, char **proflist, int *profcnt);
29 29
30 30
31 31 void free_proflist(char **proflist, int profcnt);
32 32
33 33
34 34 DESCRIPTION
35 35 The getprofattr() and getprofnam() functions each return a prof_attr
36 36 entry. Entries can come from any of the sources specified in the
|
↓ open down ↓ |
36 lines elided |
↑ open up ↑ |
37 37 nsswitch.conf(4) file.
38 38
39 39
40 40 The getprofattr() function enumerates prof_attr entries. The
41 41 getprofnam() function searches for a prof_attr entry with a given name.
42 42 Successive calls to these functions return either successive prof_attr
43 43 entries or NULL.
44 44
45 45
46 46 The internal representation of a prof_attr entry is a profattr_t
47 - structure defined in <prof_attr.h> with the following members:
47 + structure defined in <prof_attr.h> with the following members:
48 48
49 49 char *name; /* Name of the profile */
50 50 char *res1; /* Reserved for future use */
51 51 char *res2; /* Reserved for future use */
52 52 char *desc; /* Description/Purpose of the profile */
53 53 kva_t *attr; /* Profile attributes */
54 54
55 55
56 56
57 57 The free_profattr() function releases memory allocated by the
58 58 getprofattr() and getprofnam() functions.
59 59
60 60
61 61 The setprofattr() function "rewinds" to the beginning of the
62 62 enumeration of prof_attr entries. Calls to getprofnam() can leave the
63 - enumeration in an indeterminate state. Therefore, setprofattr() should
63 + enumeration in an indeterminate state. Therefore, setprofattr() should
64 64 be called before the first call to getprofattr().
65 65
66 66
67 67 The endprofattr() function may be called to indicate that prof_attr
68 68 processing is complete; the system may then close any open prof_attr
69 69 file, deallocate storage, and so forth.
70 70
71 71
72 72 The getproflist() function searches for the list of sub-profiles found
73 73 in the given profname and allocates memory to store this list in
74 74 proflist. The given profname will be included in the list of sub-
75 75 profiles. The profcnt argument indicates the number of items currently
76 76 valid in proflist. Memory allocated by getproflist() should be freed
77 77 using the free_proflist() function.
78 78
79 79
80 80 The free_proflist() function frees memory allocated by the
81 81 getproflist() function. The profcnt argument specifies the number of
82 82 items to free from the proflist argument.
83 83
|
↓ open down ↓ |
10 lines elided |
↑ open up ↑ |
84 84 RETURN VALUES
85 85 The getprofattr() function returns a pointer to a profattr_t if it
86 86 successfully enumerates an entry; otherwise it returns NULL, indicating
87 87 the end of the enumeration.
88 88
89 89
90 90 The getprofnam() function returns a pointer to a profattr_t if it
91 91 successfully locates the requested entry; otherwise it returns NULL.
92 92
93 93 USAGE
94 - Individual attributes in the prof_attr_t structure can be referred to
95 - by calling the kva_match(3SECDB) function.
94 + Individual attributes in the profattr_t structure can be referred to by
95 + calling the kva_match(3SECDB) function.
96 96
97 97
98 - Because the list of legal keys is likely to expand, any code must be
98 + Because the list of legal keys is likely to expand, any code must be
99 99 written to ignore unknown key-value pairs without error.
100 100
101 101
102 102 The getprofattr() and getprofnam() functions both allocate memory for
103 103 the pointers they return. This memory should be deallocated with the
104 104 free_profattr() function.
105 105
106 106 FILES
107 107 /etc/security/prof_attr
108 108 profiles and their descriptions
109 109
110 110
111 111 ATTRIBUTES
112 112 See attributes(5) for descriptions of the following attributes:
113 113
114 114
|
↓ open down ↓ |
6 lines elided |
↑ open up ↑ |
115 115
116 116
117 117 +---------------+-----------------+
118 118 |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
119 119 +---------------+-----------------+
120 120 |MT-Level | MT-Safe |
121 121 +---------------+-----------------+
122 122
123 123 SEE ALSO
124 124 auths(1), profiles(1), getexecattr(3SECDB), getauthattr(3SECDB),
125 - prof_attr(4)
125 + kva_match(3SECDB), prof_attr(4), attributes(5)
126 126
127 127
128 128
129 - March 31, 2005 GETPROFATTR(3SECDB)
129 + August 13, 2018 GETPROFATTR(3SECDB)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX