SETUP.PC(5)

NAME
setup.pc - master configuration file for DOS

SYNOPSIS
~/pc/setup.pc

AVAILABILITY

Available only on Sun 386i systems running a SunOS 4.0.x release or earlier. Not a SunOS 4.1 release feature.

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 serve to 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 TAB or SPACE characters:

    DOS Device SunOS 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”.

SunOS Device or Command
    The name of the device as the SunOS system knows it. This can also be 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 Device | SunOS 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
    LPT1 | lpr
    LPT2 | cat >>~/lpt-2
    LPT3 | psfx80 | 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 interrupt 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 character, 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 do not print at specific screen positions; they can print text in a current Commands window if that is where you are working 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 character, 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 user's pc directory when DOS is started for the first time.
/etc/dos/defaults/setup.pc
    Master copy of setup.pc for the workstation.

SEE ALSO
dos(1), boards.pc(5)

Sun386i User's Guide,
Sun386i Advanced Skills,
Sun MS-DOS Reference Manual