head	1.4;
access;
symbols
	RELENG_8_4:1.4.0.2
	RELENG_9_1_0_RELEASE:1.3.42.1.4.2
	RELENG_9_1:1.3.42.1.0.4
	RELENG_9_1_BP:1.3.42.1
	RELENG_8_3_0_RELEASE:1.3.36.1.8.1
	RELENG_8_3:1.3.36.1.0.8
	RELENG_8_3_BP:1.3.36.1
	RELENG_9_0_0_RELEASE:1.3.42.1.2.1
	RELENG_9_0:1.3.42.1.0.2
	RELENG_9_0_BP:1.3.42.1
	RELENG_9:1.3.0.42
	RELENG_9_BP:1.3
	RELENG_7_4_0_RELEASE:1.3.40.1
	RELENG_8_2_0_RELEASE:1.3.36.1.6.1
	RELENG_7_4:1.3.0.40
	RELENG_7_4_BP:1.3
	RELENG_8_2:1.3.36.1.0.6
	RELENG_8_2_BP:1.3.36.1
	RELENG_8_1_0_RELEASE:1.3.36.1.4.1
	RELENG_8_1:1.3.36.1.0.4
	RELENG_8_1_BP:1.3.36.1
	RELENG_7_3_0_RELEASE:1.3.38.1
	RELENG_7_3:1.3.0.38
	RELENG_7_3_BP:1.3
	RELENG_8_0_0_RELEASE:1.3.36.1.2.1
	RELENG_8_0:1.3.36.1.0.2
	RELENG_8_0_BP:1.3.36.1
	RELENG_8:1.3.0.36
	RELENG_8_BP:1.3
	RELENG_7_2_0_RELEASE:1.3.34.1
	RELENG_7_2:1.3.0.34
	RELENG_7_2_BP:1.3
	RELENG_7_1_0_RELEASE:1.3.32.1
	RELENG_6_4_0_RELEASE:1.3.30.1
	RELENG_7_1:1.3.0.32
	RELENG_7_1_BP:1.3
	RELENG_6_4:1.3.0.30
	RELENG_6_4_BP:1.3
	RELENG_7_0_0_RELEASE:1.3
	RELENG_6_3_0_RELEASE:1.3
	RELENG_7_0:1.3.0.28
	RELENG_7_0_BP:1.3
	RELENG_6_3:1.3.0.26
	RELENG_6_3_BP:1.3
	RELENG_7:1.3.0.24
	RELENG_7_BP:1.3
	RELENG_6_2_0_RELEASE:1.3
	RELENG_6_2:1.3.0.22
	RELENG_6_2_BP:1.3
	RELENG_5_5_0_RELEASE:1.3
	RELENG_5_5:1.3.0.20
	RELENG_5_5_BP:1.3
	RELENG_6_1_0_RELEASE:1.3
	RELENG_6_1:1.3.0.18
	RELENG_6_1_BP:1.3
	RELENG_6_0_0_RELEASE:1.3
	RELENG_6_0:1.3.0.16
	RELENG_6_0_BP:1.3
	RELENG_6:1.3.0.14
	RELENG_6_BP:1.3
	RELENG_5_4_0_RELEASE:1.3
	RELENG_5_4:1.3.0.12
	RELENG_5_4_BP:1.3
	RELENG_4_11_0_RELEASE:1.2.6.1
	RELENG_4_11:1.2.6.1.0.8
	RELENG_4_11_BP:1.2.6.1
	RELENG_5_3_0_RELEASE:1.3
	RELENG_5_3:1.3.0.10
	RELENG_5_3_BP:1.3
	RELENG_5:1.3.0.8
	RELENG_5_BP:1.3
	RELENG_4_10_0_RELEASE:1.2.6.1
	RELENG_4_10:1.2.6.1.0.6
	RELENG_4_10_BP:1.2.6.1
	RELENG_5_2_1_RELEASE:1.3
	RELENG_5_2_0_RELEASE:1.3
	RELENG_5_2:1.3.0.6
	RELENG_5_2_BP:1.3
	RELENG_4_9_0_RELEASE:1.2.6.1
	RELENG_4_9:1.2.6.1.0.4
	RELENG_4_9_BP:1.2.6.1
	RELENG_5_1_0_RELEASE:1.3
	RELENG_5_1:1.3.0.4
	RELENG_5_1_BP:1.3
	RELENG_4_8_0_RELEASE:1.2.6.1
	RELENG_4_8:1.2.6.1.0.2
	RELENG_4_8_BP:1.2.6.1
	RELENG_5_0_0_RELEASE:1.3
	RELENG_5_0:1.3.0.2
	RELENG_5_0_BP:1.3
	RELENG_4_7_0_RELEASE:1.2
	RELENG_4_7:1.2.0.16
	RELENG_4_7_BP:1.2
	RELENG_4_6_2_RELEASE:1.2
	RELENG_4_6_1_RELEASE:1.2
	RELENG_4_6_0_RELEASE:1.2
	RELENG_4_6:1.2.0.14
	RELENG_4_6_BP:1.2
	RELENG_4_5_0_RELEASE:1.2
	RELENG_4_5:1.2.0.12
	RELENG_4_5_BP:1.2
	RELENG_4_4_0_RELEASE:1.2
	RELENG_4_4:1.2.0.10
	RELENG_4_4_BP:1.2
	RELENG_4_3_0_RELEASE:1.2
	RELENG_4_3:1.2.0.8
	RELENG_4_3_BP:1.2
	RELENG_4_2_0_RELEASE:1.2
	RELENG_4_1_1_RELEASE:1.2
	PRE_SMPNG:1.2
	RELENG_4_1_0_RELEASE:1.2
	RELENG_3_5_0_RELEASE:1.2
	RELENG_4_0_0_RELEASE:1.2
	RELENG_4:1.2.0.6
	RELENG_4_BP:1.2
	RELENG_3_4_0_RELEASE:1.2
	RELENG_3_3_0_RELEASE:1.2
	RELENG_3_2_PAO:1.2.0.4
	RELENG_3_2_PAO_BP:1.2
	RELENG_3_2_0_RELEASE:1.2
	RELENG_3_1_0_RELEASE:1.2
	RELENG_3:1.2.0.2
	RELENG_3_BP:1.2
	RELENG_2_2_8_RELEASE:1.1.2.1
	RELENG_3_0_0_RELEASE:1.2
	RELENG_2_2_7_RELEASE:1.1.2.1
	RELENG_2_2_6_RELEASE:1.1.2.1
	RELENG_2_2_5_RELEASE:1.1
	RELENG_2_2:1.1.0.2;
locks; strict;
comment	@# @;


1.4
date	2012.11.17.01.50.31;	author svnexp;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2001.03.10.05.28.46;	author billf;	state Exp;
branches
	1.3.14.1
	1.3.24.1
	1.3.30.1
	1.3.32.1
	1.3.34.1
	1.3.36.1
	1.3.38.1
	1.3.40.1
	1.3.42.1;
next	1.2;

1.2
date	98.01.15.13.42.28;	author cracauer;	state Exp;
branches
	1.2.6.1;
next	1.1;

1.1
date	97.02.02.07.35.59;	author julian;	state Exp;
branches
	1.1.2.1;
next	;

1.4.2.1
date	2012.11.17.01.50.31;	author svnexp;	state dead;
branches;
next	1.4.2.2;

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

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

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

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

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

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

1.3.36.1
date	2009.08.03.08.13.06;	author kensmith;	state Exp;
branches
	1.3.36.1.2.1
	1.3.36.1.4.1
	1.3.36.1.6.1
	1.3.36.1.8.1;
next	1.3.36.2;

1.3.36.2
date	2012.11.17.10.36.19;	author svnexp;	state Exp;
branches;
next	;

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

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

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

1.3.36.1.8.1
date	2012.03.03.06.15.13;	author kensmith;	state Exp;
branches;
next	1.3.36.1.8.2;

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

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

1.3.40.1
date	2010.12.21.17.10.29;	author kensmith;	state Exp;
branches;
next	1.3.40.2;

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

1.3.42.1
date	2011.09.23.00.51.37;	author kensmith;	state Exp;
branches
	1.3.42.1.2.1
	1.3.42.1.4.1;
next	1.3.42.2;

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

1.3.42.1.2.1
date	2011.11.11.04.20.22;	author kensmith;	state Exp;
branches;
next	1.3.42.1.2.2;

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

1.3.42.1.4.1
date	2012.08.05.23.54.33;	author kensmith;	state Exp;
branches;
next	1.3.42.1.4.2;

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

1.2.6.1
date	2002.11.16.13.24.28;	author blackend;	state Exp;
branches;
next	1.2.6.2;

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

1.1.2.1
date	98.03.06.13.37.11;	author jkh;	state Exp;
branches;
next	;


desc
@@


1.4
log
@Switching exporter and resync
@
text
@$FreeBSD: head/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $

Author: Julian Elischer

The files in this directory are shell scripts.

They will, when run, create an example skeleton driver
for you. You can use this driver as a starting point for
writing drivers for your own devices. They have all the hooks needed
for initialization, probing, attaching, as well as DEVFS
node creation. They also create sample ioctl commands and a sample
ioctl definition .h file in /sys/sys. In other words they are fully
functional in a 'skeleton' sort of a way. They support multiple devices
so that you may have several of your 'foobar' devices probed and attached
at once.

I expect that these scripts will improve with time.

At present these scripts also link the newly created driver into
the kernel sources in /sys. Possibly a better way would be
to make them interactive. (and ask what kernel tree to use as well as
a name for the driver.).

There are presently two scripts.
One for making a real device driver for ISA devices, and 
one for making a device driver for pseudo devices (e.g. /dev/null).
Hopefully they will be joined by similar scripts for creating
skeletons for PCI and EISA devices as well.

Give them a single argument: the name of the driver.
They will use this given name in many places within the driver,
both in lower and upper case form.  (conforming to normal usage).

The skeleton driver should already link with the kernel 
and in fact the shell script will compile a kernel with the new 
drive linked in..  The new kernel should still be 
runnable and the new driver should be
fully callable (once you get your device to probe).
You should simply edit the driver and continue to use
'make' (as done in the script) until your driver does what you want.

The driver will end up in /sys/i386/isa for the device driver script,
and in /sys/dev for the pseudo driver script.
@


1.4.2.1
log
@file README was added on branch RELENG_8_4 on 2013-03-28 13:03:42 +0000
@
text
@d1 43
@


1.4.2.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 43
$FreeBSD: releng/8.4/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $

Author: Julian Elischer

The files in this directory are shell scripts.

They will, when run, create an example skeleton driver
for you. You can use this driver as a starting point for
writing drivers for your own devices. They have all the hooks needed
for initialization, probing, attaching, as well as DEVFS
node creation. They also create sample ioctl commands and a sample
ioctl definition .h file in /sys/sys. In other words they are fully
functional in a 'skeleton' sort of a way. They support multiple devices
so that you may have several of your 'foobar' devices probed and attached
at once.

I expect that these scripts will improve with time.

At present these scripts also link the newly created driver into
the kernel sources in /sys. Possibly a better way would be
to make them interactive. (and ask what kernel tree to use as well as
a name for the driver.).

There are presently two scripts.
One for making a real device driver for ISA devices, and 
one for making a device driver for pseudo devices (e.g. /dev/null).
Hopefully they will be joined by similar scripts for creating
skeletons for PCI and EISA devices as well.

Give them a single argument: the name of the driver.
They will use this given name in many places within the driver,
both in lower and upper case form.  (conforming to normal usage).

The skeleton driver should already link with the kernel 
and in fact the shell script will compile a kernel with the new 
drive linked in..  The new kernel should still be 
runnable and the new driver should be
fully callable (once you get your device to probe).
You should simply edit the driver and continue to use
'make' (as done in the script) until your driver does what you want.

The driver will end up in /sys/i386/isa for the device driver script,
and in /sys/dev for the pseudo driver script.
@


1.3
log
@fix spelling errors, clarify comment, add $FreeBSD$
@
text
@d1 1
a1 1
$FreeBSD$
@


1.3.24.1
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/7/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.14.1
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/6/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.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
@d1 1
a1 1
$FreeBSD: stable/9/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.42.1.4.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.1/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.42.1.2.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.0/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.40.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/7.4/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.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.3.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
@d1 1
a1 1
$FreeBSD: stable/8/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.36.1.8.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/8.3/share/examples/drivers/README 74061 2001-03-10 05:28:46Z billf $
@


1.3.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.3.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.3.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.3.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.3.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.3.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.2
log
@Fix typo
@
text
@d1 1
a1 1
Sat Feb  1 23:30:12 PST 1997 <Julian Elischer>
d3 3
a5 1
These files are shell scripts.
d10 1
a10 1
for intiialisation, probing, attaching, as well as DEVFS
d14 1
a14 1
so that you may have several of your 'foobar' devices probed and atached
a43 4




@


1.2.6.1
log
@MFC: 1.3
fix spelling errors, clarify comment, add $FreeBSD$

PR:	docs/45334 (for the MFC)
Submitted by:	Nicola Vitale <nivit@@libero.it>
@
text
@d1 1
a1 1
$FreeBSD$
d3 1
a3 3
Author: Julian Elischer

The files in this directory are shell scripts.
d8 1
a8 1
for initialization, probing, attaching, as well as DEVFS
d12 1
a12 1
so that you may have several of your 'foobar' devices probed and attached
d42 4
@


1.2.6.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/4/share/examples/drivers/README 106985 2002-11-16 13:24:28Z blackend $
@


1.1
log
@Description of what the files in this directory do..
(create sample device drivers on request)
@
text
@d10 1
a10 1
ioctl definition .h file in /sys/sys. In othe rwords they are fully
@


1.1.2.1
log
@MFC: typo fix
@
text
@d10 1
a10 1
ioctl definition .h file in /sys/sys. In other words they are fully
@
