MiNTOS Release 1.4.1 source 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 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. You will also need Minixfs set up as you will need to use a Minix filesystem to both build and 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 compile:- 1st) Edit the MakeVars file in this directory so that it fits your system. 2nd) Type make. This will first generate some configuration files before starting the build process itself. If you run out of memory whilst building the executables you can build the files manually by cd'ing into the source directories and running "make" by hand. 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 -+- -+- 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 "//" 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 "make install" Note: if you don't have enough memory to do this you can install the programs by running "make install" in the individual source directories. 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. All the source files and header files in the lib and include directories written by Stephen Usher are placed in the public domain so as to facilitate their incorporation into the MiNTlibs. The code written by Stephen R. Usher (except for that mentioned above) has the following licence conditions. You are free 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 that you redistribute are clearly marked as such and that you take full responsibility for the code you modify. You are also allowed without restriction to remove and re-use any portion of the code for whatever purpose. 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 3rd August, 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.