MiNTOS Release 1.4.1 binary distribution (10th September, 1994)
---------------------------------------------------------------

This file is the READ.ME file for my init/getty/login suite for MiNT on the
Atari ST/TT range of computers. This file must be kept with the binary
distribution!

This package needs MiNT version 0.90 pre-alpha patchlevel 14 or above.  I
suggest you obtain the latest version of MiNT you can. It can be found on
the Internet via anonymous FTP from atari.archive.umich.edu or its mirror
sites. You will also need Minixfs set up as you will need to use a Minix
filesystem to use the package.

MiNT version 1.00 and above are only available as a source distribution if
you don't buy them from Atari as part of the MultiTOS package, the latest
version I've heard being included in MultiTOS is 1.08.  MiNT version 1.11
will be available as a binary distribution, when this will be available is
anyone's guess.

MiNT versions after 1.10 only allow root to access TOS filesystems as a sort
of security feature, so EVERYTHING you need non-root users to access will
have to be put on a Minix or other secure filesystem.

This means that the only portion of MiNT and this package which will sit on
a TOS partition will be MiNT itself, any loadable devices/filesystems and
mint.cnf.

This directory structure contains many directories trees which represent
where the programs generated by the source will eventually go, a la Net-2
BSD and 4.4BSD. The final resting places for the executables follows SunOS
4.1.x practise rather than 4.4BSD, Linux or 4.3BSD.

When the project is complete these will contain the source for the "init"
process, "getty" process, login and passwd and related config files for MiNT
respectively. Currently, however, only versions of init(8), login(1), su(1),
passwd(1), finger(1), write(1), wlogin(1) (for MGR), ac(8), last(1), a
modified copy of sh(1) (ie. fixed), who(1) and the system logger service
daemon have been written.

The "etc" directory contains sample config files, including those for TCP/IP
programs running under MiNTnet.

The mint directory contains a sample mint.cnf file.

All the manual pages for the programs are held in the man directory.
Currently, not all the programs have manual pages written for them, this is
in the process of being remedied.

How to use:-

The example mint.cnf file shows how to make the unified filesystem look like
a correct Unix file hierarchy as shown below using symbolic links:-

   +- bin ------\ (This is merely a symbolic link to /usr/bin)
   +- dev       |
   +- etc       |
   +- tmp       v
   +- usr  -+- bin
   |        +- sbin
   |        +- ucb
   |        +- lib -+- gcc *
   |        |       +- tmac
/ -|        +- tmp
   |        +- man -+- man[1-8]
   |        |       +- cat[1-8]
   |        +- local -+- bin
   |        |         +- lib
   |        +- etc (containing TCP/IP & RPC daemons mainly, eg. in.telnetd)
   |
   +- var  -+- spool -+- mail
   |        +- adm    +- printer spool directories
   |        +- log    +- mqueue
   |                  +- uucp
   |                  +- news
   |
   +- home -+- <hostname> -+- users' home directories

* If you put your gcc executables in here without the gcc- prefix you won't
	have to set the GCC-EXEC-PREFIX environment variable!

Copy all the files from the etc directory into your /etc directory and
create an empty file in you /var/adm directory called wtmp. If you have any
config files in /etc I'd suggest you make copies first.

Edit the ttytab file so that the command in quotes points to the program you
want init to start up on each of the terminal lines (use the FULL pathname).
Usually this will be either the getty executable or the login executable.

Edit the passwd file so as to add an account for yourself. The format of the
passwd file is identical to that of the Unix passwd file. (remember to set
up your default shell)

** The root password in the sample passwd file is unset, make sure you set
	on as soon as possible!

NOTE: You will HAVE TO use the unified filesystem (U:) whilst using this
	package. All filenames should be relative to the root of this drive
	(/) as the ':' symbol is used as a delimiter in a number of files.
	If you wish to access a file on a particular logical drive use the
	form "/<drive letter>/<directory>" eg. "C:\MINT\MINT.CNF" would be
	"/c/mint/mint.cnf"

Edit the mint.cnf file supplied in the "mint" directory so as to reflect your
own set-up and copy it to the same directory as your mint.prg.

Copy the supplied Bourne shell into /bin as /bin/sh.

Type from this directory the following commands:-

	# cp -rp usr/* /usr
	# cp -rp etc/* /etc
	# cp -rp var/* /var

Restart MiNT.

   -------
** Warning **
   -------

I have tested this as well as I can, but there still could be some bugs (and
there very probably are!), therefore, to protect myself I must include the
following statement:-

By using this software you agree to take full responsibility for any actions
this software makes, including all possible damage to files, hardware (can
it?) and software.

Also, I built this binary distribution using the GNU C version contained in
the file "mfgcc258.zoo" from Atari.Archive's Mint hierarchy, this is a
version for the Falcon/TT (ie. 68030). I'm hoping that the -m68000
compilation flag used when compiling this package has produced proper 68000
code without any 68020 instructions added, I haven't been able to resurrect
my old 520STM to test it. If the programs contained within this package do
not run and you are using a 68000 based Atari machine please e-mail me
immeadiately at the following address:-

	Stephen.Usher@earth.ox.ac.uk

License:
--------

Parts of this software are copyright 1991-94 Stephen R. Usher.

Much of this package was written by other people.

The system logger package, getty, login and su are copyright the Regents of
the University of California, Berkeley and has the following license:-

/*
 * Copyright (c) 1983, 1988 Regents of the University of California.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms are permitted
 * provided that the above copyright notice and this paragraph are
 * duplicated in all such forms and that any documentation,
 * advertising materials, and other materials related to such
 * distribution and use acknowledge that the software was developed
 * by the University of California, Berkeley.  The name of the
 * University may not be used to endorse or promote products derived
 * from this software without specific prior written permission.
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
 * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 */

Code written by other people is licensed under the terms given in the source
code.

What does it run on?
--------------------

This suite of programs has been tested on Atari STM/FM, Mega ST (TOS 1.2,
1.4) and TT (TOS 3.05) series of computers running MiNT 0.91, 0.92, 0.93,
0.94, 0.95, 0.96 up to 1.10 with many patches. The baud rate of the serial
ports can only be set by getty under MiNT versions 0.95 and above and will
only work properly for the TT's extra ports from version 1.05 and above.

Stephen Usher 10th September, 1994.

Acknowledgements.
-----------------

Dave Gymer for write(1), wlogin(1), ac(8) and his suggestions for the
improvement of the rest of the package.

Alec Muffett, Robert Baldwin and Icarus Sparry for the fcrypt() routine used
in login(8) etc. (But especially Alec, for being a good friend and sending
me a copy of a pre-release version of the routine. His main handicap is that
he is an Amiga owner and now has a high-power PC running Linux ;-))

Eric Smith and his merry band of helpers for MiNT, without which none of
this would be possible :-).

Kenneth Almquist for writing ash and Stephen Neuhaus for porting it to MiNT.
There were two major bugs which I fixed, the first to do with running shell
scripts (it wasn't finding executables with extentions) and the second was
to do you job control. The files modified were exec.c and jobs.c.

Kay Roemer for MiNTnet and Portlib. Let's hope that these routines are
integrated into the mainstream MiNTlibs asap!

Terrence W. Holm for last(1).

All those people who have sent me bug reports.

Atari, for a series of computers which don't use Intel "micro-processors."
Pitty their filesystem is slow (probably caused by having to do everything in
a little-endian format) and their documentation is sparse.

And lastly....

The original authors of Unix for creating an OS using the idea of combining
many simple components to create a complex system.

AT&T for letting the University of California, Berkeley play with Unix V32
and distribute the modifications freely, allowing Unix to grow up.

The Regents of the University of California, Berkeley for releasing the
Berkeley Software Distribution for free distribution and modification.

The software engineers at UCB and Sun Microsystems Inc who made BSD 4.x and
SunOS worthy of immitation.

...And to those people at BSDI and UCB who managed to get USL to eat humble
pie...
	Thank-you, you did the whole industry a great service.
