SETUP.PC(5) — FILE FORMATS

NAME

setup.pc — master configuration file for DOS

SYNOPSIS

~/pc/setup.pc

AVAILABILITY

Sun386i systems only.

DESCRIPTION

The setup.pc file in your home PC directory, ~/pc, is the master configuration file for DOS. Changes to the file take effect for all new DOS windows you start. The definitions made in setup.pc and AUTOEXEC.BAT define your system to DOS. Among other things, the setup.pc file defines:

The printers or devices to which you assign DOS printer names (LPT1, LPT2, LPT3)

The devices or boards that are tied to the DOS communications devices (COM1, COM2)

The name of a special DOS quick-start file that you may have set up

The drive C file to be used

The format of each line is as follows; separators can be tabs or spaces:

DOS DEVICEUNIX DEVICE OR COMMAND

DOS DEVICE
The name of the device as DOS knows it. For example, the device name for the first diskette drive in DOS is “A”.

UNIX DEVICE OR COMMAND
The name of the device as UNIX knows it. This can also refer to a symbolic link to the real device name. For example, /etc/dos/defaults/diskette_a is a symbolic link to /dev/rfd0c. For emulated DOS printers (LPT1, LPT2, or LPT3), specify a command or command pipeline.

EXAMPLES

# DOS DEVICEUNIX DEVICE PATH NAME
#
A/etc/dos/defaults/diskette_a
#B/etc/dos/defaults/diskette_b
C~/pc/C:
COM1/etc/dos/defaults/com1
#COM2/etc/dos/defaults/com2
LPT1lpr
LPT2cat >>~/lpt-2
LPT3psfx80 | lpr
SAVE~/pc/.quickpc
#CMDTOOL
#TEXT
#BOARDS

# Placed at the beginning of a line to indicate a comment.

A, B Diskette drivers defined using the standard SunOS names for the Sun386i diskette drives. Drive A is normally assigned to the built-in diskette drive.

C The emulated C drive. It is actually stored as one large system file.

COM1, COM2
Serial ports. The first DOS serial port (COM1) is assigned to the Sun386i built-in serial port. To use the built-in serial port as COM2, comment out the COM1 line and uncomment the COM2 line. (DOS Windows directs the output of either COM1 or COM2 to the built-in port, but uses different interrupts levels so that COM2 “appears” to DOS to be a second serial port.) You can also add a real second serial port by installing an AT or XT card and enabling the SunOS ATS driver.

LPT1, LPT2, LPT3
Emulated printers. DOS printer names can be assigned to SunOS printers, other devices, or files.

SAVE
The “quick-start” file DOS reads at startup for faster loading.

CMDTOOL
Used to list the SunOS commands that must run in a separate Commands window when started from DOS. The following SunOS commands automatically run in a Commands window when you run them from DOS:

mail man more passwd rlogin stty vi

If there are other SunOS commands or applications you want to run from DOS, and these commands require keyboard entry or Commands window display, list them here. If you add entries to this line, separate them with a space, and be sure to remove the # (comment) symbol to activate the line.

TEXT
Specifies a list of “text-only” DOS programs. Such programs do not require a PC window because they don’t print at specific screen positions; they can print text in a current Commands window if that’s what you’re working from at the time. An example is a C compiler or a linker that runs from the DOS command line. If you place entries on this line, separate them with a space, and be sure to remove the # symbol to activate the text-only line.

BOARDS
A list of boards that DOS should attempt to activate when opening a DOS window. Each board you list here must have a corresponding entry in the boards.pc file (see boards.pc(5)).

You can create task-specific DOS environments by setting up additional setup.pc files to attach different printers, drive C files, and other real and emulated devices.

If you are installing a board that duplicates a function normally enabled in the setup.pc file, you should disable the corresponding setup.pc line by commenting it out with #.

FILES

~/pc/setup.pc
Personal setup.pc file, copied to the users pc directory when DOS is started for the first time.

/etc/dos/defaults/setup.pc
Master copy of setup.pc for the workstation.

Museum

Related Articles