|
www.riscos.com Technical Support: |
This chapter provides a short list of useful star commands which you may need to reconfigure your computer or recover from a crash. There is an alphabetical list of every * Command available under RISC OS 3 in the file StarComms in the directory Tutorials. It does not contain * Commands provided by the addition of expansion cards or extra filing systems.
Each command is followed by a short explanation of its function and its command syntax. All of these commands are explained in greater detail in the RISC OS Programmer's Reference Manual. One very useful command is *Status newr the end of this chapter.
The syntax of each command in the following sections is described in a standard way. The symbols used in syntax descriptions are;
Syntax - *Access <object_spec> [<attributes>]
Valid attributes;
L : lock object against deletion by any user
W : write permission for you
R : read permission for you
/ : separator between your permissions and the public's
W : write permission for the public (on a network)
R : read permission for the public (on a network)
*ADFS selects the Advanced Disc Filing System as the current filing system.
*CheckMap checks that the map of an E- or F-format disc has the correct checksums and is consistent with the directory tree. If only one copy of the map is good, it allows you to rewrite the bad one with the information in the good one.
Syntax - *mnsp; *CheckMap [<disc_spec>]
If the map information cannot be cured, you should backup all of your files and then reformat your hard disc. Contact your supplier for more information.
*Close closes all open files on the current filing system.
*Configure Boot (the default setting) sets the configured boot action so that a power on, reset or Ctrl Break runs a boot file.
*Configure NoBoot sets the configured boot action so that a Shift power on, Shift reset or Shift Break runs a boot file.
Syntax - *Configure Boot|NoBoot
*Configure Drive sets the configured number of the drive that is selected at power on.
*Configure FileSystem sets the configured filing system to be used at power on or hard reset.
Syntax - *Configure FileSystem <fs_name>|<fs_number>
*Configure Floppies sets the configured number of floppy disc drives recognised at power on.
Syntax - *Configure Floppies <n>
*Configure IDEDiscs sets the configured number of IDE hard disc drives recognised at power on.
Syntax - *Configure IDEDiscs <n>
*Configure Language sets the configured language used at power on.
Syntax - *Configure Language <module_no>
*Configure MouseType sets the configured pointer device to be used thereafter. Device types are 0 (Acorn quadrature mouse), 1 (Microsoft serial mouse), 2 (Mouse Systems serial mouse), or 3 (PS/2 serial mouse).
Syntax - *Configure MouseType <device_type>
*Configure Truncate sets the configured value for whether or not filenames are truncated when too long for a filing system to handle.
Syntax - *Configure Truncate On|Off
*Create reserves space for a new file. No data is transferred to the file. The optional load and execution addresses and length are in hexadecimal.
Syntax - *Create <filename> [<length> [<exec_addr> [<load_addr>]]]
*Defect reports what object contains a defect, or (if none) marks the defective part of the disc so it will no longer be used.
Syntax - *Defect <disc_spec> <disc_addr>
*DOSMap specifies a mapping between an MS-DOS extension and a RISC OS file type. If the only parameter given is an MS-DOS extension, then the mapping (if any) for that extension is cancelled. If no parameter is given, then all current mappings are listed.
The mappings are only retained until the next reset.
Syntax - *DOSMap [<MS-DOS_extension> [<file_type>]]
*FSLock_Unlock unlocks the computer, so you can alter its CMOS RAM and hard disc. If the -full switch is not given then the computer will only be unlocked until it is next reset.
Syntax - *FSLock_Unlock [-full] [<password>]
*Help Commands : lists all available utility commands
*Help FileCommands : lists all the command relating to filing systems
*Help Modules : lists the names of all currently loaded modules, with their version numbers and creation dates
*Help Station : displays the current network and station numbers of your machine
*Help Syntax : explains the format used for syntax messages
*List displays the contents of the named file using the configured DumpFormat. Each line is numbered.
Syntax - *List [-File] <filename> [-TabExpand]
*Opt 4 sets the boot action for the current filing system:
*Opt 4,0 : no boot action
*Opt 4,1 : *Load boot file
*Opt 4,2 : *Run boot file
*Opt 4,3 : *Exec boot file
*Podules displays a list of the installed expansion cards and extension ROMs.
*Ram selects the RAM filing system as the current filing system.
*ResourceFS selects the Resource Filing System as the current filing system.
*RMKill deactivates and deletes a relocatable module. Use this command only with extreme caution, as it may be drastic in its effects.
Syntax - *RMKill <module_title>[<%instantiation>]
*RMReInit reinitialises a relocatable module, reversing the action of any previous *RMKill or *Unplug command. Use this command only with extreme caution, as it may be drastic in its effects.
Syntax - *RMReInit <module_title> [<module_init_string>]
*ScreenLoad loads the contents of a sprite file into the graphics window.
Syntax - *ScreenLoad <filename>
*ScreenSave saves the contents of the graphics window and its palette to a file.
Syntax - *ScreenSave <filename>
*SCSI selects the SCSI Filing System as the current filing system. This command is only available if you have a SCSI expansion card fitted.
*Shut closes all open files on all filing systems.
*ShutDown closes all open files on all filing systems, logs off all network file servers, and parks hard disc heads.
*Status displays the value of a configuration option in the CMOS RAM. If no option is specified, the values of all configuration options are shown.
*Unplug kills and disables all copies of a ROM resident module. If no parameters are given, the unplugged ROM modules are listed.
Syntax - *Unplug [<module_title> [<ROM_section>]]