Return to coh_intro.c CVS log

Up to [MW Coherent from dump] / coherent / b / etc / Build_401

coherent

/*
 * coh_intro.c
 * 06/29/92	COHERENT 386
 * 06/22/93	COHERENT 4.2
 * Usage: coh_intro
 * Uses routines in build0.c: cc -o coh_intro coh_intro.c build0.c
 */

#include <stdio.h>
#include "build0.h"

#define	VERSION		"2.2"
#define	DEFPAGER	"exec more -d"

/* External. */
extern	char	*getenv();

/* Forward. */
int	lcdir();
void	mycls();
void	tour();

/* Global. */
char	*pager;
int	ttyflag;

main(argc, argv) int argc; char *argv[];
{
	if (argc > 1 && argv[1][0] == '-' && argv[1][1] == 'V')
		fprintf(stderr, "%s: V%s\n", argv[0], VERSION);
	ttyflag = isatty(fileno(stdout));
	if ((pager = getenv("PAGER")) == NULL || *pager == '\0')
		pager = DEFPAGER;
	if (!ttyflag || yes_no("Would you like an introductory tour of COHERENT"))
		tour();
	exit(0);
}

/*
 * List the contents of a directory.
 * Flush stdout in case output is redirected.
 * If pflag is true (big directory), pipe output through PAGER.
 */
int
lcdir(dir, msg, pflag) char *dir, *msg; int pflag;
{
	mycls(1);
	printf(msg);
	fflush(stdout);
	if (ttyflag && pflag)
		sprintf(cmd, "lc %s | %s", dir, pager);
	else
		sprintf(cmd, "lc %s", dir);
	return sys(cmd, S_IGNORE);
}

/* Print newlines if stdout is redirected; otherwise, clear the screen. */
void
mycls(flag)
{
	if (ttyflag)
		cls(flag);
	else
		printf("\n\n");
}

/* Take a walk on the Boardwalk... */
void
tour()
{
	mycls(0);
	/* Startup and shutdown. */
	printf(
"When you boot your computer system (by turning on the power,\n"
"by hitting the reset switch, or by typing <Ctrl><Alt><Del>),\n"
"the bootstrap program by default runs the operating system on\n"
"the partition marked as active.  To boot an operating system\n"
"system on a different partition, type a partition number (0 to 7)\n"
"when the boot tries to read the floppy disk.\n"
"\n"
"When you boot COHERENT, it starts up in single-user mode.\n"
"It automatically executes the commands in the file /etc/brc,\n"
"which typically check COHERENT filesystems for consistency\n"
"using /etc/fsck.  If the filesystems check without errors,\n"
"the system goes into multi-user mode, automatically executing\n"
"the commands in the file /etc/rc.  You can interrupt file system\n"
"checking by typing <Ctrl-C>.\n"
"\n"
"To shut down COHERENT from multi-user mode, log in as root and\n"
"execute /etc/shutdown to return the system to single-user mode.\n"
"Then type sync before rebooting or turning off the power.\n"
"Your COHERENT filesystems may be damaged if you reboot or\n"
"power down without following this procedure.\n"
"\n"
		);

	/* Root. */
	lcdir("/", 
"Now we will take a quick tour of your COHERENT filesystem.\n"
"The root directory / contains:\n\n",
		0);
	printf(
"\n"
"COHERENT executes file /.profile when the superuser root logs in.\n"
"File /coherent (linked to /autoboot) is the COHERENT system image.\n"
"Empty directories /f0 and /f1 are used for mounting diskettes.\n"
"Empty directory /mnt is used for mounting other devices.\n"
"The filesystem checking program /etc/fsck uses empty directory\n"
"/lost+found if it finds a problem with the root filesystem.\n"
"COHERENT uses directory /tmp for temporary files; it removes files\n"
"in /tmp automatically when the system goes multiuser (via /etc/rc).\n"
"\n"
		);

	/* /bin. */
	mycls(1);
	printf(
"Directory /bin contains executable programs (commands).\n"
"Some of the most commonly used commands are:\n"
"\tbc\tinteractive calculator with arbitrary precision\n"
"\tcat\tconcatenate/print files\n"
"\tcc\tC compiler\n"
"\tcmp\tcompare files\n"
"\tcp\tcopy files\n"
"\tcpdir\tcopy directory hierarchy\n"
"\tdiff\tsummarize differences between files\n"
"\tdoscp\ttransfer files to or from MS-DOS\n"
"\tegrep\textended pattern search\n"
"\temacs\tMicroEMACS screen editor\n"
"\thelp\tprint concise command description\n"
"\tls\tlist directory contents\n"
"\tmail\tcomputer mail\n"
"\tmore\tview files one screenful at a time\n"
"\tps\tprint process status\n"
"\trm\tremove files\n"
"\trmdir\tremove directories\n"
"\tsort\tsort lines of text\n"
"\tvi\ta popular screen editor\n"
"\twc\tcount words, lines, characters in a file\n"
"The next screen lists all the commands in /bin.\n"
		);
	lcdir("/bin", "", 1);
	putchar('\n');

	/* /conf. */
	lcdir("/conf", "Directory /conf contains:\n\n", 0);
	putchar('\n');

	/* /conf/kbd. */
	lcdir ("/conf/kbd",
		"Subdirectory /conf/kbd contains keyboard support:\n\n",
		0);
	printf(
"\n"
"You can change the operation of various keys on your keyboard by changing\n"
"the appropriate file in /conf/kbd and running /etc/kbdinstall.\n"
		);

	/* /dev. */
	lcdir("/dev", "Directory /dev contains COHERENT devices:\n\n", 1);
	putchar('\n');
	mycls(1);
	printf(
"Some important devices are:\n"
"\t/dev/at*\tCooked (block-by-block) hard disk partitions\n"
#if _I386
"\t/dev/color*\tVirtual console: color video devices\n"
#endif
"\t/dev/com*\tSerial port devices (COM1, COM2, COM3, COM4)\n"
"\t/dev/console\tConsole terminal\n"
"\t/dev/f*\t\tFloppy disk devices\n"
"\t/dev/lpt*\tParallel port devices (LPT1, LPT2 and LPT3)\n"
#if _I386
"\t/dev/mono*\tVirtual console: monochrome video devices\n"
#endif
"\t/dev/null\tBit bucket\n"
#if _I386
"\t/dev/pty*\tPseudo-terminal devices\n"
#endif
"\t/dev/rat*\tRaw (character-by-character) hard disk partitions\n"
"\t/dev/rf*\tRaw (character-by-character) floppy disk devices\n"
#if _I386
"\t/dev/rsd*\tRaw (character-by-character) SCSI devices\n"
"\t/dev/sd*\tCooked (block-by-block) SCSI devices\n"
#endif
"\t/dev/tty*\tTerminal devices\n"
"\n"
		);
#if !_I386
	/* /drv. */
	lcdir("/drv", "Directory /drv contains loadable device drivers:\n\n", 0);
	putchar('\n');
#endif
	/* /etc. */
	lcdir("/etc",
"Directory /etc contains files and programs used in system administration:\n\n",
		0);
	putchar('\n');
	mycls(1);
	printf(
"Files of particular interest in /etc include:\n"
"\t/etc/brc\tExecuted when the system comes up single-user\n"
"\t/etc/domain\tDefines the electronic mail \"domain\"\n"
"\t/etc/group\tDefines user group membership information\n"
"\t/etc/passwd\tDefines user login information\n"
"\t/etc/profile\tExecuted for each shell\n"
"\t/etc/rc\t\tExecuted when the system comes up multi-user\n"
"\t/etc/ttys\tDefines status of terminals attached to system\n"
"\t/etc/ttytype\tDefines the types of terminals attached to system\n"
"\t/etc/uucpname\tDefines the system name for use with UUCP\n"
"\n"
		);
	/* /etc/default. */
	lcdir("/etc/default",
"Directory /etc/default contains configuration files used by some commands:\n\n",
		0);
	putchar('\n');
	printf(
"Files of particular interest in /etc/default include:\n"
"\t/etc/default/async\tSpecifies serial port hardware configuration\n"
"\t/etc/default/msdos\tSpecifies defaults for the /bin/dos* commands\n"
"\n"
		);

	/* /lib. */
	lcdir("/lib",
		"Directory /lib contains libraries and C compiler phases:\n\n",
		0);
	putchar('\n');

	/* /usr. */
	lcdir("/usr",
		"Directory /usr contains a number of subdirectories:\n\n",
		0);
	printf(
"\n"
"\t/usr/adm\tSystem administration files\n"
"\t/usr/bin\tAdditional COHERENT commands\n"
"\t/usr/dict\tDictionary for spell command\n"
"\t/usr/games\tGames\n"
"\t/usr/include\tHeader files\n"
"\t/usr/lib\tAdditional libraries\n"
"\t/usr/man\tCOHERENT online manual pages\n"
"\t/usr/msgs\tSystem-wide messages\n"
"\t/usr/pub\tPublic information\n"
"\t/usr/spool\tWork area for daemon processes\n"
"\t/usr/src\tSome sources and sample programs\n"
"\t/usr/tmp\tTemporary file directory\n"
"\n"
		);

	/* Shells */
	mycls(1);
	printf(
"The COHERENT system includes the following shells (command interpreters):\n\n"
"\t/usr/bin/vsh\tThe COHERENT visual (full screen) shell\n"
"\t/usr/bin/ksh\tThe Korn shell\n"
"\t/bin/sh\t\tThe Bourne shell\n"
"\n"
		);
	/* File types. */
	mycls(1);
	printf(
"COHERENT filenames often contain an extension following '.' which\n"
"indicates the contents of the file.  Some common extensions are:\n"
"\n"
"\t.a\tarchive (or library) in ar format\n"
"\t.b\tbc source\n"
"\t.c\tC source\n"
"\t.h\tC header\n"
"\t.i\tC intermediate file (cpp output)\n"
"\t.l\tlex source\n"
"\t.m\tmacro assembler source\n"
"\t.o\tobject file (unlinked)\n"
"\t.r\tnroff or troff input\n"
"\t.s\tassembler source\n"
"\t.tar\tarchive in tar format\n"
"\t.tar.Z\tcompressed tar-format archive, cf. tar, compress\n"
"\t.tmp\ttemporary file\n"
"\t.y\tyacc source\n"
"\t.Z\tcompressed file, cf. compress/uncompress\n"
"\n"
	);

	/* Diskettes. */
	mycls(1);
	printf(
"Some commonly used diskette device names and formats are:\n\n"
"\tDevice name  Sectors/track  Heads  Sectors  Bytes   Format\n"
"\t/dev/f9a0          9          2      720    360 KB   5.25\"\n"
"\t/dev/fqa0          9          2     1440    720 KB   3.5\"\n"
"\t/dev/fha0         15          2     2400    1.2 MB   5.25\"\n"
"\t/dev/fva0         18          2     2880    1.44 MB  3.5\"\n"
"\nDevice names ending in '0' and '1' indicate drives A: and B:.\n"
"In addition, wherever possible, common floppy device names are provided for\n"
"compatibility with other operating systems.\n"
"\n"
		);
	mycls(1);
	printf(
"To use a floppy disk filesystem with COHERENT, you must:\n\n"
"\t(1) format and verify it with /etc/fdformat,\n"
"\t(2) build an empty filesystem on it with /etc/mkfs,\n"
"\t(3) mount it with /bin/mount or /etc/mount,\n"
"\t(4) copy files to or from it, e.g. with /bin/cp or /bin/cpdir,\n"
"and\t(5) unmount it with /bin/umount or /etc/umount.\n"
"\n"
"For example, to copy directory /dir to a 5.25\" high density diskette in A:\n\n"
"\t/etc/fdformat -av /dev/rfha0\n"
"\t/etc/mkfs /dev/fha0 2400\n"
"\t/etc/mount /dev/fha0 /f0\n"
"\tcpdir -vd /dir /f0/dir\n"
"\t/etc/umount /dev/fha0\n\n"
"/bin/mount and /bin/umount provide handy abbreviations for \"mount\" commands.\n"
"\n"
		);

	/* Done. */
	mycls(1);
	printf(
"This concludes your brief introduction to COHERENT.\n"
"To see this introduction again, type \"/etc/coh_intro\".\n"
"To create a file with this information, type \"/etc/coh_intro >/tmp/tour\".\n"
"\n"
		);
}

/* end of coh_intro.c */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.