head	1.5;
access;
symbols
	RELENG_8_4:1.5.0.2
	RELENG_9_1_0_RELEASE:1.4.42.1.4.2
	RELENG_9_1:1.4.42.1.0.4
	RELENG_9_1_BP:1.4.42.1
	RELENG_8_3_0_RELEASE:1.4.36.1.8.1
	RELENG_8_3:1.4.36.1.0.8
	RELENG_8_3_BP:1.4.36.1
	RELENG_9_0_0_RELEASE:1.4.42.1.2.1
	RELENG_9_0:1.4.42.1.0.2
	RELENG_9_0_BP:1.4.42.1
	RELENG_9:1.4.0.42
	RELENG_9_BP:1.4
	RELENG_7_4_0_RELEASE:1.4.40.1
	RELENG_8_2_0_RELEASE:1.4.36.1.6.1
	RELENG_7_4:1.4.0.40
	RELENG_7_4_BP:1.4
	RELENG_8_2:1.4.36.1.0.6
	RELENG_8_2_BP:1.4.36.1
	RELENG_8_1_0_RELEASE:1.4.36.1.4.1
	RELENG_8_1:1.4.36.1.0.4
	RELENG_8_1_BP:1.4.36.1
	RELENG_7_3_0_RELEASE:1.4.38.1
	RELENG_7_3:1.4.0.38
	RELENG_7_3_BP:1.4
	RELENG_8_0_0_RELEASE:1.4.36.1.2.1
	RELENG_8_0:1.4.36.1.0.2
	RELENG_8_0_BP:1.4.36.1
	RELENG_8:1.4.0.36
	RELENG_8_BP:1.4
	RELENG_7_2_0_RELEASE:1.4.34.1
	RELENG_7_2:1.4.0.34
	RELENG_7_2_BP:1.4
	RELENG_7_1_0_RELEASE:1.4.32.1
	RELENG_6_4_0_RELEASE:1.4.30.1
	RELENG_7_1:1.4.0.32
	RELENG_7_1_BP:1.4
	RELENG_6_4:1.4.0.30
	RELENG_6_4_BP:1.4
	RELENG_7_0_0_RELEASE:1.4
	RELENG_6_3_0_RELEASE:1.4
	RELENG_7_0:1.4.0.28
	RELENG_7_0_BP:1.4
	RELENG_6_3:1.4.0.26
	RELENG_6_3_BP:1.4
	RELENG_7:1.4.0.24
	RELENG_7_BP:1.4
	RELENG_6_2_0_RELEASE:1.4
	RELENG_6_2:1.4.0.22
	RELENG_6_2_BP:1.4
	RELENG_5_5_0_RELEASE:1.4
	RELENG_5_5:1.4.0.20
	RELENG_5_5_BP:1.4
	RELENG_6_1_0_RELEASE:1.4
	RELENG_6_1:1.4.0.18
	RELENG_6_1_BP:1.4
	RELENG_6_0_0_RELEASE:1.4
	RELENG_6_0:1.4.0.16
	RELENG_6_0_BP:1.4
	RELENG_6:1.4.0.14
	RELENG_6_BP:1.4
	RELENG_5_4_0_RELEASE:1.4
	RELENG_5_4:1.4.0.12
	RELENG_5_4_BP:1.4
	RELENG_4_11_0_RELEASE:1.3.4.1
	RELENG_4_11:1.3.4.1.0.12
	RELENG_4_11_BP:1.3.4.1
	RELENG_5_3_0_RELEASE:1.4
	RELENG_5_3:1.4.0.10
	RELENG_5_3_BP:1.4
	RELENG_5:1.4.0.8
	RELENG_5_BP:1.4
	RELENG_4_10_0_RELEASE:1.3.4.1
	RELENG_4_10:1.3.4.1.0.10
	RELENG_4_10_BP:1.3.4.1
	RELENG_5_2_1_RELEASE:1.4
	RELENG_5_2_0_RELEASE:1.4
	RELENG_5_2:1.4.0.6
	RELENG_5_2_BP:1.4
	RELENG_4_9_0_RELEASE:1.3.4.1
	RELENG_4_9:1.3.4.1.0.8
	RELENG_4_9_BP:1.3.4.1
	RELENG_5_1_0_RELEASE:1.4
	RELENG_5_1:1.4.0.4
	RELENG_5_1_BP:1.4
	RELENG_4_8_0_RELEASE:1.3.4.1
	RELENG_4_8:1.3.4.1.0.6
	RELENG_4_8_BP:1.3.4.1
	RELENG_5_0_0_RELEASE:1.4
	RELENG_5_0:1.4.0.2
	RELENG_5_0_BP:1.4
	RELENG_4_7_0_RELEASE:1.3.4.1
	RELENG_4_7:1.3.4.1.0.4
	RELENG_4_7_BP:1.3.4.1
	RELENG_4_6_2_RELEASE:1.3.4.1
	RELENG_4_6_1_RELEASE:1.3.4.1
	RELENG_4_6_0_RELEASE:1.3.4.1
	RELENG_4_6:1.3.4.1.0.2
	RELENG_4_6_BP:1.3.4.1
	RELENG_4_5_0_RELEASE:1.3
	RELENG_4_5:1.3.0.10
	RELENG_4_5_BP:1.3
	RELENG_4_4_0_RELEASE:1.3
	RELENG_4_4:1.3.0.8
	RELENG_4_4_BP:1.3
	RELENG_4_3_0_RELEASE:1.3
	RELENG_4_3:1.3.0.6
	RELENG_4_3_BP:1.3
	RELENG_4_2_0_RELEASE:1.3
	RELENG_4_1_1_RELEASE:1.3
	PRE_SMPNG:1.3
	RELENG_4_1_0_RELEASE:1.3
	RELENG_3_5_0_RELEASE:1.3.2.1
	RELENG_4_0_0_RELEASE:1.3
	RELENG_4:1.3.0.4
	RELENG_4_BP:1.3
	RELENG_3:1.3.0.2;
locks; strict;
comment	@# @;


1.5
date	2012.11.17.01.50.31;	author svnexp;	state Exp;
branches
	1.5.2.1;
next	1.4;

1.4
date	2002.03.15.06.47.37;	author luigi;	state Exp;
branches
	1.4.14.1
	1.4.24.1
	1.4.30.1
	1.4.32.1
	1.4.34.1
	1.4.36.1
	1.4.38.1
	1.4.40.1
	1.4.42.1;
next	1.3;

1.3
date	99.02.09.17.43.59;	author dillon;	state Exp;
branches
	1.3.2.1
	1.3.4.1;
next	1.2;

1.2
date	99.01.26.23.11.09;	author dillon;	state Exp;
branches;
next	1.1;

1.1
date	99.01.26.19.04.14;	author dillon;	state Exp;
branches;
next	;

1.5.2.1
date	2012.11.17.01.50.31;	author svnexp;	state dead;
branches;
next	1.5.2.2;

1.5.2.2
date	2013.03.28.13.03.42;	author svnexp;	state Exp;
branches;
next	;

1.4.14.1
date	2012.11.17.07.41.32;	author svnexp;	state Exp;
branches;
next	;

1.4.24.1
date	2012.11.17.08.03.52;	author svnexp;	state Exp;
branches;
next	;

1.4.30.1
date	2008.10.02.02.57.24;	author kensmith;	state Exp;
branches;
next	;

1.4.32.1
date	2008.11.25.02.59.29;	author kensmith;	state Exp;
branches;
next	;

1.4.34.1
date	2009.04.15.03.14.26;	author kensmith;	state Exp;
branches;
next	;

1.4.36.1
date	2009.08.03.08.13.06;	author kensmith;	state Exp;
branches
	1.4.36.1.2.1
	1.4.36.1.4.1
	1.4.36.1.6.1
	1.4.36.1.8.1;
next	1.4.36.2;

1.4.36.2
date	2012.11.17.10.36.18;	author svnexp;	state Exp;
branches;
next	;

1.4.36.1.2.1
date	2009.10.25.01.10.29;	author kensmith;	state Exp;
branches;
next	;

1.4.36.1.4.1
date	2010.06.14.02.09.06;	author kensmith;	state Exp;
branches;
next	;

1.4.36.1.6.1
date	2010.12.21.17.09.25;	author kensmith;	state Exp;
branches;
next	;

1.4.36.1.8.1
date	2012.03.03.06.15.13;	author kensmith;	state Exp;
branches;
next	1.4.36.1.8.2;

1.4.36.1.8.2
date	2012.11.17.08.24.59;	author svnexp;	state Exp;
branches;
next	;

1.4.38.1
date	2010.02.10.00.26.20;	author kensmith;	state Exp;
branches;
next	;

1.4.40.1
date	2010.12.21.17.10.29;	author kensmith;	state Exp;
branches;
next	1.4.40.2;

1.4.40.2
date	2012.11.17.08.16.56;	author svnexp;	state Exp;
branches;
next	;

1.4.42.1
date	2011.09.23.00.51.37;	author kensmith;	state Exp;
branches
	1.4.42.1.2.1
	1.4.42.1.4.1;
next	1.4.42.2;

1.4.42.2
date	2012.11.17.11.36.35;	author svnexp;	state Exp;
branches;
next	;

1.4.42.1.2.1
date	2011.11.11.04.20.22;	author kensmith;	state Exp;
branches;
next	1.4.42.1.2.2;

1.4.42.1.2.2
date	2012.11.17.08.36.34;	author svnexp;	state Exp;
branches;
next	;

1.4.42.1.4.1
date	2012.08.05.23.54.33;	author kensmith;	state Exp;
branches;
next	1.4.42.1.4.2;

1.4.42.1.4.2
date	2012.11.17.08.47.24;	author svnexp;	state Exp;
branches;
next	;

1.3.2.1
date	99.12.21.16.58.18;	author phantom;	state Exp;
branches;
next	;

1.3.4.1
date	2002.03.15.06.52.38;	author luigi;	state Exp;
branches;
next	1.3.4.2;

1.3.4.2
date	2012.11.17.07.24.44;	author svnexp;	state Exp;
branches;
next	;


desc
@@


1.5
log
@Switching exporter and resync
@
text
@IMPORTANT NOTE:

As of Feb. 11, 2002 (and indeed, for quite some time before that),
the /etc/rc.diskless{1,2} scripts support a slightly different
diskless boot process than the one documented in the rest of
this file (which is 3 years old).

I am not deleting the information below because it contains some
useful background information on diskless operation, but for the
actual details you should look at /etc/rc.diskless1, /etc/rc.diskless2,
and the /usr/share/examples/diskless/clone_root script which can
be useful to set up clients and server for diskless boot.

--- $FreeBSD: head/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
------------------------------------------------------------------------

When templating, /conf/ME is typically a softlink to
/conf/<appropriate-machine>.  When doing a diskless boot, /conf/ME is
retargeted by /etc/rc.diskless1 from pointing to the server to pointing
to the client's directory, /conf/<ip-address-of-client>.  The retargeting
is accomplished through an MFS -o union mount.

When templating, this softlink should be different for each machine.
When doing a diskless boot, this softlink is typically part of the / NFS
mount from the server and points to the server's conf directory, but gets
retargeted during the /etc/rc.diskless1 phase.

System-wide configuration files must generally be targeted through /conf/ME.
For example, your /etc/rc.conf.local should become a softlink to
/conf/ME/rc.conf.local and your real rc.conf.local should go into the 
appropriate /conf/<appropriate-machine> directory.  This is also true of
/etc/rc.local, /etc/fstab, /etc/syslog.conf, /etc/ccd.conf, /etc/ipfw.conf,
/etc/motd, /etc/resolv.conf, and possibly even /etc/ttys ( if you want
to start an X session up on boot on certain of your machines ).

When templating, you duplicate your / and /usr partitions on each machine's
local disk from a single master ( assuming /var and /home reside elsewhere ),
EXCEPT for the /conf/ME softlink.  The /conf/ME softlink is the only thing
on / that should be different for each machine.

There are often categories of configuration files.  For example, all of your
shell machines may use one resolv.conf while all of your mail proxies may
use another.  Configuration files can be categorized fairly easily through
/conf/HT.<category> directories.  You put the actual configuration file in
/conf/HT.<category> and make a softlink from
/conf/ME/<appropriate-machines>/config-file to "../HT.<category/config-file".
This means that access to these files tends to run through more then one
softlink.  The advantage is that for all the complexity of your /conf
directory hierarchy, most of your common config files exist in only one place
in reality.


@


1.5.2.1
log
@file ME was added on branch RELENG_8_4 on 2013-03-28 13:03:42 +0000
@
text
@d1 52
@


1.5.2.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 52
IMPORTANT NOTE:

As of Feb. 11, 2002 (and indeed, for quite some time before that),
the /etc/rc.diskless{1,2} scripts support a slightly different
diskless boot process than the one documented in the rest of
this file (which is 3 years old).

I am not deleting the information below because it contains some
useful background information on diskless operation, but for the
actual details you should look at /etc/rc.diskless1, /etc/rc.diskless2,
and the /usr/share/examples/diskless/clone_root script which can
be useful to set up clients and server for diskless boot.

--- $FreeBSD: releng/8.4/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
------------------------------------------------------------------------

When templating, /conf/ME is typically a softlink to
/conf/<appropriate-machine>.  When doing a diskless boot, /conf/ME is
retargeted by /etc/rc.diskless1 from pointing to the server to pointing
to the client's directory, /conf/<ip-address-of-client>.  The retargeting
is accomplished through an MFS -o union mount.

When templating, this softlink should be different for each machine.
When doing a diskless boot, this softlink is typically part of the / NFS
mount from the server and points to the server's conf directory, but gets
retargeted during the /etc/rc.diskless1 phase.

System-wide configuration files must generally be targeted through /conf/ME.
For example, your /etc/rc.conf.local should become a softlink to
/conf/ME/rc.conf.local and your real rc.conf.local should go into the 
appropriate /conf/<appropriate-machine> directory.  This is also true of
/etc/rc.local, /etc/fstab, /etc/syslog.conf, /etc/ccd.conf, /etc/ipfw.conf,
/etc/motd, /etc/resolv.conf, and possibly even /etc/ttys ( if you want
to start an X session up on boot on certain of your machines ).

When templating, you duplicate your / and /usr partitions on each machine's
local disk from a single master ( assuming /var and /home reside elsewhere ),
EXCEPT for the /conf/ME softlink.  The /conf/ME softlink is the only thing
on / that should be different for each machine.

There are often categories of configuration files.  For example, all of your
shell machines may use one resolv.conf while all of your mail proxies may
use another.  Configuration files can be categorized fairly easily through
/conf/HT.<category> directories.  You put the actual configuration file in
/conf/HT.<category> and make a softlink from
/conf/ME/<appropriate-machines>/config-file to "../HT.<category/config-file".
This means that access to these files tends to run through more then one
softlink.  The advantage is that for all the complexity of your /conf
directory hierarchy, most of your common config files exist in only one place
in reality.


@


1.4
log
@Add comments to ME README.BOOTP README.TEMPLATING mentioning that
they contain stale information.
Remove files referring to the old diskless setup to avoid confusion.
@
text
@d14 1
a14 1
--- $FreeBSD$ ---
@


1.4.24.1
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: stable/7/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.14.1
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: stable/6/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.42.1
log
@SVN rev 225736 on 2011-09-23 00:51:37Z by kensmith

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.4.42.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242902
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242902 | dteske | 2012-11-11 23:29:45 +0000 (Sun, 11 Nov 2012) | 10 lines
## SVN ##
## SVN ## Fix a regression introduced by SVN r211417 that saw the breakage of a feature
## SVN ## documented in usr.sbin/sysinstall/help/shortcuts.hlp (reproduced below):
## SVN ##
## SVN ## If /usr/sbin/sysinstall is linked to another filename, say
## SVN ## `/usr/local/bin/configPackages', then the basename will be used
## SVN ## as an implicit command name.
## SVN ##
## SVN ## Reviewed by:	adrian (co-mentor)
## SVN ## Approved by:	adrian (co-mentor)
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d14 1
a14 1
--- $FreeBSD: stable/9/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.42.1.4.1
log
@SVN rev 239080 on 2012-08-05 23:54:33Z by kensmith

Copy stable/9 to releng/9.1 as part of the 9.1-RELEASE release process.

Approved by:	re (implicit)
@
text
@@


1.4.42.1.4.2
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: releng/9.1/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.42.1.2.1
log
@SVN rev 227445 on 2011-11-11 04:20:22Z by kensmith

Copy stable/9 to releng/9.0 as part of the FreeBSD 9.0-RELEASE release
cycle.

Approved by:	re (implicit)
@
text
@@


1.4.42.1.2.2
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: releng/9.0/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.40.1
log
@SVN rev 216618 on 2010-12-21 17:10:29Z by kensmith

Copy stable/7 to releng/7.4 in preparation for FreeBSD-7.4 release.

Approved by:	re (implicit)
@
text
@@


1.4.40.2
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: releng/7.4/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.38.1
log
@SVN rev 203736 on 2010-02-10 00:26:20Z by kensmith

Copy stable/7 to releng/7.3 as part of the 7.3-RELEASE process.

Approved by:	re (implicit)
@
text
@@


1.4.36.1
log
@SVN rev 196045 on 2009-08-03 08:13:06Z by kensmith

Copy head to stable/8 as part of 8.0 Release cycle.

Approved by:	re (Implicit)
@
text
@@


1.4.36.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242909
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242909 | dim | 2012-11-12 07:47:19 +0000 (Mon, 12 Nov 2012) | 20 lines
## SVN ##
## SVN ## MFC r242625:
## SVN ##
## SVN ## Remove duplicate const specifiers in many drivers (I hope I got all of
## SVN ## them, please let me know if not).  Most of these are of the form:
## SVN ##
## SVN ## static const struct bzzt_type {
## SVN ##       [...list of members...]
## SVN ## } const bzzt_devs[] = {
## SVN ##       [...list of initializers...]
## SVN ## };
## SVN ##
## SVN ## The second const is unnecessary, as arrays cannot be modified anyway,
## SVN ## and if the elements are const, the whole thing is const automatically
## SVN ## (e.g. it is placed in .rodata).
## SVN ##
## SVN ## I have verified this does not change the binary output of a full kernel
## SVN ## build (except for build timestamps embedded in the object files).
## SVN ##
## SVN ## Reviewed by:	yongari, marius
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d14 1
a14 1
--- $FreeBSD: stable/8/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.36.1.8.1
log
@SVN rev 232438 on 2012-03-03 06:15:13Z by kensmith

Copy stable/8 to releng/8.3 as part of 8.3-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.4.36.1.8.2
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: releng/8.3/share/examples/diskless/ME 92302 2002-03-15 06:47:38Z luigi $ ---
@


1.4.36.1.6.1
log
@SVN rev 216617 on 2010-12-21 17:09:25Z by kensmith

Copy stable/8 to releng/8.2 in preparation for FreeBSD-8.2 release.

Approved by:	re (implicit)
@
text
@@


1.4.36.1.4.1
log
@SVN rev 209145 on 2010-06-14 02:09:06Z by kensmith

Copy stable/8 to releng/8.1 in preparation for 8.1-RC1.

Approved by:	re (implicit)
@
text
@@


1.4.36.1.2.1
log
@SVN rev 198460 on 2009-10-25 01:10:29Z by kensmith

Copy stable/8 to releng/8.0 as part of 8.0-RELEASE release procedure.

Approved by:	re (implicit)
@
text
@@


1.4.34.1
log
@SVN rev 191087 on 2009-04-15 03:14:26Z by kensmith

Create releng/7.2 from stable/7 in preparation for 7.2-RELEASE.

Approved by:	re (implicit)
@
text
@@


1.4.32.1
log
@SVN rev 185281 on 2008-11-25 02:59:29Z by kensmith

Create releng/7.1 in preparation for moving into RC phase of 7.1 release
cycle.

Approved by:	re (implicit)
@
text
@@


1.4.30.1
log
@SVN rev 183531 on 2008-10-02 02:57:24Z by kensmith

Create releng/6.4 from stable/6 in preparation for 6.4-RC1.

Approved by:	re (implicit)
@
text
@@


1.3
log
@    Update diskless and templated booting examples
@
text
@d1 15
@


1.3.4.1
log
@Add a comment informing that the information in this file might be stale.
@
text
@a0 15
IMPORTANT NOTE:

As of Feb. 11, 2002 (and indeed, for quite some time before that),
the /etc/rc.diskless{1,2} scripts support a slightly different
diskless boot process than the one documented in the rest of
this file (which is 3 years old).

I am not deleting the information below because it contains some
useful background information on diskless operation, but for the
actual details you should look at /etc/rc.diskless1, /etc/rc.diskless2,
and the /usr/share/examples/diskless/clone_root script which can
be useful to set up clients and server for diskless boot.

--- $FreeBSD$ ---
------------------------------------------------------------------------
@


1.3.4.2
log
@Switch importer
@
text
@d14 1
a14 1
--- $FreeBSD: stable/4/share/examples/diskless/ME 92303 2002-03-15 06:52:38Z luigi $ ---
@


1.3.2.1
log
@MFC: Bring diskless examples to RELENG_3

PR:		conf/12026
Submitted by:	Brooks Davis <brooks@@one-eyed-alien.net>
@
text
@d37 1
a37 1
$FreeBSD$
@


1.2
log
@    Clarify documentation of 'ME' softlink.
@
text
@d2 5
a6 6
When templating, ME is typically a softlink to the appropriate host
subdirectory.  This softlink is different for each machine and
should not be updated by the template process.  Any system-wise configuration
file that needs to be personalized is typically turned into a softlink
through /conf/ME.  For example, /etc/rc.conf.local would be turned into a
softlink pointing to /conf/ME/rc.conf.local.
d8 4
a11 3
On any given machine, ME is typically a link to the hostname which also
exists as a subdirectory in the /conf directory.  So, for each machine you
do:
d13 23
a35 2
	cd /conf
	ln -s this_machines_name ME
a36 2
The ME link is not used with diskless booting.  It is designed for templating
where each destination box has its own local disk.
@


1.1
log
@    Diskless and templating configuration examples
@
text
@d2 16
a17 2
( When templating, ME is typically a softlink to the appropriate host
subdirectory )
@

