summaryrefslogtreecommitdiffstats
path: root/usr.sbin/bsdconfig/share/variable.subr
blob: e841029c05443eae9e85a8b9a4001d3238091129 (plain)
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
if [ ! "$_VARIABLE_SUBR" ]; then _VARIABLE_SUBR=1
#
# Copyright (c) 2012-2013 Devin Teske
# All Rights Reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
# 1. Redistributions of source code must retain the above copyright
#    notice, this list of conditions and the following disclaimer.
# 2. Redistributions in binary form must reproduce the above copyright
#    notice, this list of conditions and the following disclaimer in the
#    documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
# $FreeBSD$
#
############################################################ INCLUDES

BSDCFG_SHARE="/usr/share/bsdconfig"
. $BSDCFG_SHARE/common.subr || exit 1
f_dprintf "%s: loading includes..." variable.subr
f_include $BSDCFG_SHARE/dialog.subr
f_include $BSDCFG_SHARE/strings.subr

############################################################ GLOBALS

VARIABLES=

#
# Default behavior is to call f_variable_set_defaults() when loaded.
#
: ${VARIABLE_SELF_INITIALIZE=1}

#
# File to write when f_dump_variables() is called.
#
: ${VARIABLE_DUMPFILE:=/etc/bsdconfig.vars}

############################################################ FUNCTIONS

# f_variable_new $handle $variable
#
# Register a new variable named $variable with the given reference-handle
# $handle. The environment variable $handle is set to $variable allowing you to
# use the f_getvar() function (from common.subr) with $handle to get the value
# of environment variable $variable. For example:
#
# 	f_variable_new VAR_ABC abc
#
# allows the later indirection:
#
# 	f_getvar $VAR_ABC
#
# to return the value of environment variable `abc'. Variables registered in
# this manner are recorded in the $VARIABLES environment variable for later
# allowing dynamic enumeration of so-called `registered/advertised' variables.
#
f_variable_new()
{
	local handle="$1" variable="$2"
	[ "$handle" ] || return $FAILURE
	f_dprintf "variable.subr: New variable %s -> %s" "$handle" "$variable"
	setvar $handle $variable
	VARIABLES="$VARIABLES${VARIABLES:+ }$handle"
}

# f_variable_get_value $var [ $fmt [ $opts ... ] ]
#
# Unless nonInteractive is set, prompt the user with a given value (pre-filled
# with the value of $var) and give them the chance to change the value.
#
# Unlike f_getvar() (from common.subr) which can return a variable to the
# caller on standard output, this function has no [meaningful] output.
#
# Returns success unless $var is either NULL or missing.
#
f_variable_get_value()
{
	local var="$1" cp

	[ "$var" ] || return $FAILURE

	if ! { f_getvar $var cp && ! f_interactive; }; then
		shift 1 # var
		f_dialog_input cp "$( printf "$@" )" "$cp" && setvar $var "$cp"
	fi

	return $SUCCESS
}

# f_variable_set_defaults
#
# Installs sensible defaults for registered/advertised variables.
#
f_variable_set_defaults()
{
	#
	# Initialize various user-edittable values to their defaults
	#
	setvar $VAR_EDITOR		"${EDITOR:-/usr/bin/ee}"
	setvar $VAR_FTP_STATE		"auto"
	setvar $VAR_FTP_USER		"ftp"
	setvar $VAR_HOSTNAME		"$( hostname )"
	setvar $VAR_MEDIA_TIMEOUT	"300"
	setvar $VAR_NFS_SECURE		"NO"
	setvar $VAR_NFS_TCP		"NO"
	setvar $VAR_NFS_V3		"YES"
	setvar $VAR_PKG_TMPDIR		"/var/tmp"
	setvar $VAR_RELNAME		"$UNAME_R"

	f_dprintf "f_variable_set_defaults: Defaults initialized."
}

# f_dump_variables
#
# Dump a list of registered/advertised variables and their respective values to
# $VARIABLE_DUMPFILE. Returns success unless the file couldn't be written. If
# an error occurs, it is displayed using f_dialog_msgbox() (from dialog.subr).
#
f_dump_variables()
{
	local err
	if ! err=$(
		( for handle in $VARIABLES; do
			f_getvar $handle var || continue
			f_getvar $var value || continue
			f_shell_escape "$value" value
			printf "%s='%s'\n" "$var" "$value"
		  done > "$VARIABLE_DUMPFILE" ) 2>&1
	); then
		f_dialog_msgbox "$err"
		return $FAILURE
	fi
}

# f_debugging
#
# Are we in debug mode? Returns success if extra DEBUG information has been
# requested (by setting $debug to non-NULL), otherwise false.
#
f_debugging()
{
	local value
	f_getvar $VAR_DEBUG value && [ "$value" ]
}

# f_interactive()
#
# Are we running interactively? Return error if $nonInteractive is set and non-
# NULL, otherwise return success.
#
f_interactive()
{
	local value
	! f_getvar $VAR_NONINTERACTIVE value || [ ! "$value" ]
}

# f_netinteractive()
#
# Has the user specifically requested the network-portion of configuration and
# setup to be performed interactively? Returns success if the user has asked
# for the network configuration to be done interactively even if perhaps over-
# all non-interactive mode has been requested (by setting nonInteractive).
#
# Returns success if $netInteractive is set and non-NULL.
#
f_netinteractive()
{
	local value
	f_getvar $VAR_NETINTERACTIVE value && [ "$value" ]
}

############################################################ MAIN

#
# Variables that can be tweaked from config files
#
#              Handle                   Variable Name
f_variable_new VAR_CONFIG_FILE		configFile
f_variable_new VAR_DEBUG		debug
f_variable_new VAR_DEBUG_FILE		debugFile
f_variable_new VAR_DIRECTORY_PATH	_directoryPath
f_variable_new VAR_DOMAINNAME		domainname
f_variable_new VAR_EDITOR		editor
f_variable_new VAR_EXTRAS		ifconfig_
f_variable_new VAR_FTP_DIR		ftpDirectory
f_variable_new VAR_FTP_HOST		ftpHost
f_variable_new VAR_FTP_PASS		ftpPass
f_variable_new VAR_FTP_PATH		_ftpPath
f_variable_new VAR_FTP_PORT		ftpPort
f_variable_new VAR_FTP_STATE		ftpState
f_variable_new VAR_FTP_USER		ftpUser
f_variable_new VAR_GATEWAY		defaultrouter
f_variable_new VAR_HOSTNAME		hostname
f_variable_new VAR_HTTP_DIR		httpDirectory
f_variable_new VAR_HTTP_FTP_MODE	httpFtpMode
f_variable_new VAR_HTTP_HOST		httpHost
f_variable_new VAR_HTTP_PATH		_httpPath
f_variable_new VAR_HTTP_PORT		httpPort
f_variable_new VAR_HTTP_PROXY		httpProxy
f_variable_new VAR_HTTP_PROXY_HOST	httpProxyHost
f_variable_new VAR_HTTP_PROXY_PATH	_httpProxyPath
f_variable_new VAR_HTTP_PROXY_PORT	httpProxyPort
f_variable_new VAR_IFCONFIG		ifconfig_
f_variable_new VAR_IPADDR		ipaddr
f_variable_new VAR_IPV6ADDR		ipv6addr
f_variable_new VAR_IPV6_ENABLE		ipv6_activate_all_interfaces
f_variable_new VAR_MEDIA_TIMEOUT	MEDIA_TIMEOUT
f_variable_new VAR_MEDIA_TYPE		mediaType
f_variable_new VAR_NAMESERVER		nameserver
f_variable_new VAR_NETINTERACTIVE	netInteractive
f_variable_new VAR_NETMASK		netmask
f_variable_new VAR_NETWORK_DEVICE	netDev
f_variable_new VAR_NFS_HOST		nfsHost
f_variable_new VAR_NFS_PATH		nfsPath
f_variable_new VAR_NFS_SECURE		nfs_reserved_port_only
f_variable_new VAR_NFS_TCP		nfs_use_tcp
f_variable_new VAR_NFS_V3		nfs_use_v3
f_variable_new VAR_NONINTERACTIVE	nonInteractive
f_variable_new VAR_NO_CONFIRM		noConfirm
f_variable_new VAR_NO_ERROR		noError
f_variable_new VAR_NO_INET6		noInet6
f_variable_new VAR_PACKAGE		package
f_variable_new VAR_PKG_TMPDIR		PKG_TMPDIR
f_variable_new VAR_PORTS_PATH		ports
f_variable_new VAR_RELNAME		releaseName
f_variable_new VAR_SLOW_ETHER		slowEthernetCard
f_variable_new VAR_TRY_DHCP		tryDHCP
f_variable_new VAR_TRY_RTSOL		tryRTSOL
f_variable_new VAR_UFS_PATH		ufs

#
# Self-initialize unless requested otherwise
#
f_dprintf "%s: VARIABLE_SELF_INITIALIZE=[%s]" \
          variable.subr "$VARIABLE_SELF_INITIALIZE"
case "$VARIABLE_SELF_INITIALIZE" in
""|0|[Nn][Oo]|[Oo][Ff][Ff]|[Ff][Aa][Ll][Ss][Ee]) : do nothing ;;
*) f_variable_set_defaults
esac

f_dprintf "%s: Successfully loaded." variable.subr

fi # ! $_VARIABLE_SUBR
OpenPOWER on IntegriCloud