Find a file
John Dyson 84af4da65a Finish up the vast majority of the AIO/LIO functionality. Proper signal
support was missing in the previous version of the AIO code.  More
tunables added, and very efficient support for VCHR files has been added.
Kernel threads are not used for VCHR files, all work for such files is
done for the requesting process directly.  Some attempt has been made to
charge the requesting process for resource utilization, but more work
is needed.  aio_fsync is still missing (but the original fsync system
call can be used for now.)  aio_cancel is essentially a noop, but that
is okay per POSIX.  More aio_cancel functionality can be added later,
if it is found to be needed.

The functions implemented include:
	aio_read, aio_write, lio_listio, aio_error, aio_return,
	aio_cancel, aio_suspend.

The code has been implemented to support the POSIX spec 1003.1b
(formerly known as POSIX 1003.4 spec) features of the above.  The
async I/O features are truly async, with the VCHR mode of operation
being essentially the same as physio (for appropriate files) for
maximum efficiency.  This code also supports the signal capability,
is highly tunable, allowing management of resource usage, and
has been written to allow a per process usage quota.

Both the O'Reilly POSIX.4 book and the actual POSIX 1003.1b document
were the reference specs used.  Any filedescriptor can be used with
these new system calls.  I know of no exceptions where these
system calls will not work.  (TTY's will also probably work.)
1997-11-30 04:36:31 +00:00
bin Reviewed by: hackers@freebsd.org in general 1997-11-13 00:28:51 +00:00
contrib The previous revision (objfiles.c:1.2) fixed backtracing in the 1997-11-27 21:26:08 +00:00
crypto kinit(1) and its man page do not agre on what is reported with -v. Fix this. 1997-11-25 21:12:37 +00:00
etc datasize-curr -> datasize-cur, typo fix. 1997-11-27 17:52:52 +00:00
games Remove bogus declaration of calloc() that broke the build. Test, folks, 1997-09-26 06:25:42 +00:00
gnu Always call gripe_reading_mp_config with the required arguments. 1997-11-30 01:01:47 +00:00
include Remove the prototypes for dlopen and related functions. They don't 1997-11-28 19:05:11 +00:00
kerberos5 Fix a break in the includes where the build blows chunks if it is 1997-10-02 15:03:23 +00:00
kerberosIV Link this against -lcrypt. In the case where the user has no key available 1997-10-24 16:27:46 +00:00
lib s/geteid/geteuid/ - it's lucky I have a large supply of left-over pointy 1997-11-29 11:39:31 +00:00
libexec Get rid of the dynamic linker's internal malloc package, and arrange 1997-11-29 03:32:48 +00:00
lkm - The daemon might go off the screen and crashed the system if the 1997-10-26 07:35:18 +00:00
release Remove an extraneous ".kbd" that crept in for the Swiss German 1997-11-26 22:48:24 +00:00
sbin Fix syntax error for the mount_mfs example. 1997-11-24 03:28:54 +00:00
secure Staticise a variable. 1997-10-08 07:02:48 +00:00
share Fixed spelling of EACCES. 1997-11-23 17:58:55 +00:00
sys Finish up the vast majority of the AIO/LIO functionality. Proper signal 1997-11-30 04:36:31 +00:00
tools Add html-mv script. Html-mv rename HTML generated filenames to 1997-11-09 11:23:54 +00:00
usr.bin In the "ldd -v" output, display the N_AUX information for each 1997-11-28 19:34:27 +00:00
usr.sbin Remove an extraneous ".kbd" that crept in for the Swiss German 1997-11-26 22:48:24 +00:00
COPYRIGHT This is the official 4.4 Lite copyright. 1994-09-11 07:53:28 +00:00
Makefile Do not use -B in initial build of "make". It doesn't exist in 2.1.x. 1997-10-10 13:02:36 +00:00
README Note that /etc is not installed by world target either. 1997-08-09 14:36:20 +00:00

This is the top level of the FreeBSD source directory.  This file
was last revised on: $Id: README,v 1.10 1997/02/23 09:18:39 peter Exp $

For copyright information, please see the file COPYRIGHT in this
directory (additional copyright information also exists for some
sources in this tree - please see the specific source directories for
more information).

The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
kernel and the contents of /etc.  Please see the top of the Makefile
in this directory for more information on the standard build targets
and compile-time flags.

Building a kernel with config(8) is a somewhat more involved process,
documentation for which can be found at:
   http://www.freebsd.org/handbook/kernelconfig.html
And in the config(8) man page.

The sample kernel configuration files reside in the sys/i386/conf
sub-directory (assuming that you've installed the kernel sources), the
file named GENERIC being the one used to build your initial installation
kernel.  The file LINT contains entries for all possible devices, not
just those commonly used, and is meant more as a general reference
than an actual kernel configuration file (a kernel built from it
wouldn't even run).


Source Roadmap:
---------------
bin		System/User commands.

contrib		Packages contributed by 3rd parties.

eBones		Kerberos package - NOT FOR EXPORT!

etc		Template files for /etc

games		Amusements.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

lib		System libraries.

libexec		System daemons.

lkm		Loadable Kernel Modules.

release		Release building Makefile & associated tools.

sbin		System commands.

secure		DES and DES-related utilities - NOT FOR EXPORT!

share		Shared resources.

sys		Kernel sources.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.


For information on synchronizing your source tree with one or more of
the FreeBSD Project's development branches, please see:

  http://www.freebsd.org/handbook/synching.html