xref: /dflybsd-src/share/man/man5/varsym.conf.5 (revision 5522551ec4fa4ecf42c37ee0065f393e62e25908)
13a31409dSSascha Wildner.\"
23a31409dSSascha Wildner.\" Copyright (c) 2007
33a31409dSSascha Wildner.\"	The DragonFly Project.  All rights reserved.
43a31409dSSascha Wildner.\"
53a31409dSSascha Wildner.\" Redistribution and use in source and binary forms, with or without
63a31409dSSascha Wildner.\" modification, are permitted provided that the following conditions
73a31409dSSascha Wildner.\" are met:
83a31409dSSascha Wildner.\"
93a31409dSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
103a31409dSSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
113a31409dSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
123a31409dSSascha Wildner.\"    notice, this list of conditions and the following disclaimer in
133a31409dSSascha Wildner.\"    the documentation and/or other materials provided with the
143a31409dSSascha Wildner.\"    distribution.
153a31409dSSascha Wildner.\" 3. Neither the name of The DragonFly Project nor the names of its
163a31409dSSascha Wildner.\"    contributors may be used to endorse or promote products derived
173a31409dSSascha Wildner.\"    from this software without specific, prior written permission.
183a31409dSSascha Wildner.\"
193a31409dSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
203a31409dSSascha Wildner.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
213a31409dSSascha Wildner.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
223a31409dSSascha Wildner.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
233a31409dSSascha Wildner.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
243a31409dSSascha Wildner.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
253a31409dSSascha Wildner.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
263a31409dSSascha Wildner.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
273a31409dSSascha Wildner.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
283a31409dSSascha Wildner.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
293a31409dSSascha Wildner.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
303a31409dSSascha Wildner.\" SUCH DAMAGE.
313a31409dSSascha Wildner.\"
32*5522551eSAaron LI.Dd December 19, 2018
333a31409dSSascha Wildner.Dt VARSYM.CONF 5
34fb5b3747SSascha Wildner.Os
353a31409dSSascha Wildner.Sh NAME
363a31409dSSascha Wildner.Nm varsym.conf
373a31409dSSascha Wildner.Nd set system-wide
385b989360SSascha Wildner.Xr varsym 1
393a31409dSSascha Wildnervariables
403a31409dSSascha Wildner.Sh SYNOPSIS
413a31409dSSascha Wildner.Pa /etc/varsym.conf
423a31409dSSascha Wildner.Sh DESCRIPTION
433a31409dSSascha WildnerThe
443a31409dSSascha Wildner.Nm
45*5522551eSAaron LIfile specifies a list of system-wide variables that can then be used in
46*5522551eSAaron LIvariant symlinks.
47*5522551eSAaron LIEach line specifies one variable and its data in the same format of the
48*5522551eSAaron LI.Xr varsym 1
49*5522551eSAaron LIcommand, i.e.,
50*5522551eSAaron LI.Bd -literal -offset indent
51*5522551eSAaron LIvar=data
52*5522551eSAaron LI"variable name"="variable data"
53*5522551eSAaron LI.Ed
54*5522551eSAaron LI.Pp
55*5522551eSAaron LISpaces are not allowed around the
56*5522551eSAaron LI.Dq =
57*5522551eSAaron LIsign.
58*5522551eSAaron LIBoth the variable name and data can contain spaces but must be quoted.
593a31409dSSascha WildnerEmpty lines or lines beginning with a
603a31409dSSascha Wildner.Dq #
613a31409dSSascha Wildnerare ignored.
62*5522551eSAaron LIInline comments should not be used.
633a31409dSSascha Wildner.Pp
643a31409dSSascha WildnerProcessing
653a31409dSSascha Wildner.Nm
663a31409dSSascha Wildneris activated by setting
673a31409dSSascha Wildner.Va varsym_enable
683a31409dSSascha Wildnerin
69b502d041SSascha Wildner.Pa /etc/rc.conf
70b502d041SSascha Wildnerand setting the
713a31409dSSascha Wildner.Va vfs.varsym_enable
723a31409dSSascha Wildnersysctl.
733a31409dSSascha Wildner.Sh FILES
743a31409dSSascha Wildner.Bl -tag -width ".Pa /etc/varsym.conf" -compact
753a31409dSSascha Wildner.It Pa /etc/varsym.conf
763a31409dSSascha Wildnerconfiguration file for specifying system-wide
775b989360SSascha Wildner.Xr varsym 1
783a31409dSSascha Wildnervariables
793a31409dSSascha Wildner.El
803a31409dSSascha Wildner.Sh SEE ALSO
813a31409dSSascha Wildner.Xr ln 1 ,
82d58949acSSascha Wildner.Xr varsym 1 ,
833a31409dSSascha Wildner.Xr rc.conf 5
843a31409dSSascha Wildner.Sh AUTHORS
853a31409dSSascha WildnerThis manual page was written by
863a31409dSSascha Wildner.An Sascha Wildner .
87