Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 31 Aug 2006 16:09:02 -0400
From:      Garance A Drosehn <gad@FreeBSD.org>
To:        John Baldwin <jhb@FreeBSD.org>, Tom Rhodes <trhodes@FreeBSD.org>
Cc:        cvs-src@FreeBSD.org, src-committers@FreeBSD.org, Ruslan Ermilov <ru@FreeBSD.org>, cvs-all@FreeBSD.org
Subject:   Re: "Chatty" config files in /etc
Message-ID:  <p0623091fc11cee9097e7@[128.113.24.47]>
In-Reply-To: <200608310848.30549.jhb@freebsd.org>
References:  <200608290920.k7T9KmV9067843@repoman.freebsd.org> <20060831100004.GB52914@rambler-co.ru> <20060831061806.0c022552.trhodes@FreeBSD.org> <200608310848.30549.jhb@freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
At 8:48 AM -0400 8/31/06, John Baldwin wrote:
>On Thursday 31 August 2006 06:18, Tom Rhodes wrote:
>>  On Thu, 31 Aug 2006 14:00:04 +0400
>  > Ruslan Ermilov <ru@FreeBSD.org> wrote:
>>
>  > > No, /etc/defaults are different beasties -- they are true
>>  > default config files -- they are either used if there's no
>>  > corresponding version under /etc, or most likely sourced
>>  > to provide defaults.  To be moved to /etc/defaults, a file
>>  > should gain the same property.
>>
>>  While this comment is blatently obvious: /etc/examples
>
>This is already spelled /usr/share/examples/etc in FreeBSD.

Actually, as it stands right now that is not quite the same
thing.  Right now /usr/share/examples/etc holds *exact copies*
of the files we install in /etc, for the reasons as described
in /usr/share/examples/etc/README.examples :

    The /usr/share/examples/etc directory contains the original
    distribution versions of the files which are shipped in /etc.
    This is intended to make it easy to recover when the /etc
    versions are accidentally deleted or broken beyond repair.

We can obviously change the intent of that directory, but I
noticed that README as I was writing my previous message, and
I wasn't sure if we would want to change the present intent.
(which is why I said nothing about it in my previous message)

One other observation:  The directory /usr/share/examples/pf
holds several files, which are several different examples of
how someone might want to setup 'pf'.  But /etc/pf.conf (and
the duplicate in /usr/share/examples/etc/pf.conf ) give one
specific example that "the project" recommends as a starting
point.  I have no idea if that is a significant distinction,
I'm just noticing that we seem to have that subtle distinction.

>/etc/defaults would just be wrong for examples, that directory
>is for default settings (note that /etc/defaults/rc.conf is not
>just comments, but sets default values for various settings..
>same with /etc/defaults/periodic.conf, etc.)

That is a good point.  I would also be happy with putting such
files in a new /etc/examples directory.  One advantage to
having them all in a directory is that projects like nanobsd
can safely remove the entire directory, and know that nothing
will be broken by doing that.

So I have no strong opinion about where the example files should
go, just as long as the real file includes a pointer to that
location.  I slightly favor "somewhere under /etc" for the
reasons I listed earlier, but would also be happy enough if
they show up in /usr/share/examples .

-- 
Garance Alistair Drosehn     =               drosehn@rpi.edu
Senior Systems Programmer               or   gad@FreeBSD.org
Rensselaer Polytechnic Institute;             Troy, NY;  USA



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?p0623091fc11cee9097e7>