aboutsummaryrefslogtreecommitdiffstats
path: root/enum_libenv_class.3
blob: e5fa1a0aa327d09a266878f2a6e7509230dc38ce (plain) (blame)
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
.TH ENUM_LIBENV_CLASS 3 libenv
.SH NAME
enum libenv_class - Environment variables classes

.SH SYNOPSIS
.nf
#include <libenv.h>

enum libenv_class {
	LIBENV_END = 0,
	/* ... members omitted, see listing below ...  */
};
.fi

.SH DESCRIPTION
The
.B enum libenv_class
contains one dummy value,
.IR LIBENV_END ,
used to mark the end of a class list for variadic functions.
In addition to this dummy value, it also contains the following
values used to describe a class of environment variables:
.TP
.B LIBENV_DISPLAY
Environment variables necessary for the
graphical environment.
.TP
.B LIBENV_DISPLAY_CONFIG
Environment variables that configure
the graphical environment.
.TP
.B LIBENV_DESKTOP
Environment variables that describe
the desktop environment.
.TP
.B LIBENV_TERMINAL_CAPS
Environment variables that describe
the terminal's capabilities.
.TP
.B LIBENV_LOCAL_TERMINAL
Environment variables that describe
the terminals but is only meaningful
for the local host.
.TP
.B LIBENV_LOCALE
Environment variables that configure
the locale.
.TP
.B LIBENV_TIMEZONE
Environment variables that configure
the timezone.
.TP
.B LIBENV_SESSION
Environment variables that describe
the current session.

This includes, for example, variables
added by
.BR sshd (8)
to describe the remote connection.

This does not include display, desktop,
or terminal information, nor does
include information to identify the
user.
.TP
.B LIBENV_THEME_CONFIG
Environment variables that configure
the user's theme.

This excludes variables listed for
.IR LIBENV_THEME_PLUGIN ,
except in the
hypothetical scenario where it names
a plugin and additional configurations.
.TP
.B LIBENV_THEME_PLUGIN
Environment variables that describe
the plugins the user's theme requires.
.TP
.B LIBENV_INTERNET
Environment variables that configures
the user's Internet connection,
including mainly proxies.
.TP
.B LIBENV_AUDIO
Environment variables that configures
the user's audio.
.TP
.B LIBENV_USER
Environment variables that describe
any information gathered about the
user from
.BR passwd (5)
or login parameters.
.TP
.B LIBENV_APPLICATIONS
Environment variables that default
applications configured for the user.
.TP
.B LIBENV_PREFERENCES
Environment variables that configure
preferences, for the user, for various
applications.
.TP
.B LIBENV_SYSTEM_PATHS
Environment variables that list directories
configured system wide (but could be
overwritten for the user).

Environment variables with this classification
also have at least
.IR LIBENV_PATH .
.TP
.B LIBENV_USER_PATHS
Environment variables that list directories
configured for the user.

Environment variables with this classification
also have at least
.IR LIBENV_PATH .
.TP
.B LIBENV_PWD
Environment variables that contain
current and past working directories.

Environment variables with this classification
also have at least
.IR LIBENV_PATH .
.TP
.B LIBENV_EXEC
Environment variables that contain
information about the executed utility.
.TP
.B LIBENV_PATH
Environment variables that contain
filesystem paths.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_REMOTE_UNSAFE
Environment variables that should be removed
when entering a remote session.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_REMOTE_SAFE
Environment variables that can safely be kept
when entering a remote session.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_LOGIN_UNSAFE
Environment variables that should be removed
when logging in as a new user.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_LOGIN_SAFE
Environment variables that can safely be
kept when logging in as a new user.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_SU_UNSAFE
Environment variables that should be removed
when escalating privileges.

Any environment variable with this
classification has at least one other
classification.
.TP
.B LIBENV_SU_SAFE
Environment variables that can safely be
kept when escalating privileges.

Any environment variable with this
classification has at least one other
classification.

.SH SEE ALSO
.BR libenv (7),
.BR libenv_get_chosen_list (3),
.BR libenv_filter_variable_list (3),
.BR libenv_select_variable_list (3).