MiNTOS Release 1.2 source distribution (30th March, 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 source!

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. 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 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.

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. I'm on the way to getting the BSD line printer
stuff working, though this may need the MiNTnet software to get it working.

The etc directory contains sample config files.

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 compile:-

1st) Edit the makefile in this directory so that it fits your system.

Either

2nd) Type make.

Or if you don't have enough memory for make

2nd) Examine the makefile and manually copy the executables from the
	directories into their proper places.

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
   +- dev
   +- etc
   +- tmp
   +- usr  -+- lib -+- gcc *
   |        |       +- tmac
/ -|        +- tmp
   |        +- man -+- man[1-8]
   |        |       +- cat[1-8]
   |        +- bin
   |        +- ucb
   |        +- local -+- bin
   |                  +- lib
   |
   +- home -+- user's home directories
   |
   +- var  -+- spool -+- mail
            |         +- printer spool directories
            +- adm
            +- log

* 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.

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 "etc" 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 "make install"

Note: if you don't have enough memory to do this you can install the
	programs manually using the commands in the makefile as a guide.

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.

License:
--------

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

Much of this package was written by other people, to see who please read the
sources provided.

The code written by Stephen R. Usher has the following licence conditions.

You are allowed to copy, distribute and modify the source code included in
this package as long as the following conditions are met:-

(1) This file is kept with all the other files in this distribution.

(2) Any files which are modified by you are clearly marked as such and that
	you take full responsibility for the code you modify.

You may terminate this license at any time by destroying all original and
modified copies of this package.

You are deemed to have agreed with the terms of this license if you have a
copy of this program in your posession.

If you are resident in, and the package has been supplied in, the United
States of America, it is agreed that the laws of California shall govern
without reference to the place of execution or performance, except as to
copyright matters which are covered by Federal laws. If you are resident,
and the package has been supplied, elsewhere other than in the United States
of America, it is agreed that the laws of England shall govern without
reference to the place of execution or performance.

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 30th March, 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.

Terrence W. Holm for last(1).

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.
