xref: /titanic_50/usr/src/cmd/cmd-inet/etc/wanboot.conf.sample (revision 84f7a9b9dca4f23b5f50edef0e59d7eb44301114)
1#
2# Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
3# Use is subject to license terms.
4#
5# CDDL HEADER START
6#
7# The contents of this file are subject to the terms of the
8# Common Development and Distribution License, Version 1.0 only
9# (the "License").  You may not use this file except in compliance
10# with the License.
11#
12# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
13# or http://www.opensolaris.org/os/licensing.
14# See the License for the specific language governing permissions
15# and limitations under the License.
16#
17# When distributing Covered Code, include this CDDL HEADER in each
18# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
19# If applicable, add the following below this CDDL HEADER, with the
20# fields enclosed by brackets "[]" replaced with your own identifying
21# information: Portions Copyright [yyyy] [name of copyright owner]
22#
23# CDDL HEADER END
24#
25# ident	"%Z%%M%	%I%	%E% SMI"
26
27####################################################################
28# wanboot.conf(4): boot configuration file.
29#
30# Please consult wanboot.conf(4) for further information.  Note that
31# this interface is "Evolving" as defined by attributes(5).
32#
33# Anything after a '#' is comment.  Values may be quoted (e.g. "val").
34#
35# <empty> means there is no value, i.e. null.  The absence of any
36# parameter implies that it takes a default value (<empty> unless
37# otherwise specified).
38#
39# <url> is of the form http://... or https://...
40####################################################################
41
42# The path of the bootstrap file (within htdocs) which is served up
43# by wanboot-cgi(bootfile).
44#
45boot_file=/bootfiles/wanboot	# <absolute pathname>
46
47# These are used by wanboot-cgi(bootfile|bootfs|rootfs) to determine
48# whether boot_file or the bootfs is to be sent encrypted/signed, or
49# root_file is to be sent signed; the client must be setup with the
50# corresponding encryption/signature key(s) (which cannot be auto-
51# matically verified).
52#
53# If an encryption_type is specified then a signature_type must also
54# be specified.
55#
56encryption_type=3des		# 3des | aes | <empty>
57signature_type=sha1		# sha1 | <empty>
58
59# This is used by wanboot-cgi(bootfs) and wanboot to determine whether
60# server authentication should be requested during SSL connection
61# setup.
62#
63server_authentication=yes	# yes | no
64
65# This is used by wanboot-cgi(bootfs) and wanboot to determine whether
66# client authentication should be requested during SSL connection
67# setup.  If client_authentication is "yes", then server_authentication
68# must also be "yes".
69#
70client_authentication=yes	# yes | no
71
72# wanboot-cgi(bootfs) will construct a hosts file which resolves any
73# hostnames specified in any of the URLs in the wanboot.conf file,
74# plus those found in certificates, etc.  The following parameter
75# may be used to add additional mappings to the hosts file.
76#
77resolve_hosts=			# <hostname>[,<hostname>*] | <empty>
78
79# This is used to specify the URL of wanboot-cgi on the server on which
80# the root_file exists, and used by wanboot to obtain the root server's
81# URL; wanboot substitutes root_file for the pathname part of the URL.
82# If the schema is http://... then the root_file will be signed if there
83# is a non-empty signature_type.  If server_authentication is "yes", the
84# schema must be https://...; otherwise it must be http://...
85#
86root_server=https://host:port/cgi-bin/wanboot-cgi	# <url> | <empty>
87
88# This is used by wanboot-cgi(rootfs) to locate the path of the
89# rootfs image (within htdocs) on the root_server.
90#
91root_file=/rootimages/miniroot	# <absolute pathname> | <empty>
92
93# This is used by wanboot to determine the URL of the bootserver
94# (and whether bootlog traffic should be sent using http or https),
95# or whether it should simply be sent to the console.
96#
97boot_logger=			# <url> | <empty>
98
99# This is used by the system startup scripts. If set, it should
100# point to a file that contains name value pairs to be used at
101# start up time. For example, this file may be used to provide
102# install the values for sysidcfg and jumpscfg.
103#
104system_conf=system.conf
105