8 Other commands The commands in this section are recognised by the operating system, and passed to the filing system through various vectors, primarily OSFILE and FSCV. In some cases, the parameters are interpreted by the operating system; in others, they are passed to the filing system to interpret. 8.1 *. This is shorthand for *CAT. 8.2 */fsp : : : This is shorthand for *RUN. It allows file specifications including directories to be given easily , without the operating system mistaking the directory for an abbreviated command. 8.3 *CAT (dsp) This command lists the catalogue for the directory specified, or the current directory if none is given. HDFS reports the name of the directory being listed, and then the directory title, cycle or key number, number of sectors allocated, start sector, boot-up option, current directory and current library before the actual catalogue. The catalogue is listed in alphabetical order, with the permissions after each file. Acorn format (DNFS) catalogues are listed with the current directory first and its' directory character missing, and then the other directories, in alphabetical order. In HDFS format catalogues, the flag D next to the permissions indicates that the entry is a directory. In 80-column modes, four files are displayed on each line; in 20 and 40-column modes, two files are listed on each line. 8.4 *EXEC fsp Files can be used as keyboard input with this command. The contents of the file are operated on exactly as if they had been typed at the keyboard. The main use of *EXEC is for auto-boot files which run applications. 8.5 *HELP (HDFS/UTILS) This command prints out the help available from the ROM. W ith no keyword, HDFS prints the version number, and the keywords to which *HELP will respond. If the HDFS keyword is given, the syntax of all of the filing system commands in section 6 will be printed. The UTILS keyword causes the syntax of all of the utility commands in section 7 to be printed. 8.6 *LOAD fsp (addr) This command loads a file to the address specified, or to its' own load address if no address is given. The address may be in I/O processor memory or second processor memory; if the address is in I/O processor memory, and it would erase the HDFS private workspace, the ROM filing system (RFS) is invoked after the file is loaded. This allows large files to be loaded to low memory addresses safely. If the address is in I/O processor memory, and in the range &8000-&BFFF, the data is loaded into the sideways ROM socket given by the value of *OPT 3. 8.7 *OPT dec(,dec) This command sets the filing system options. The numbers determine which option is to be set, and what its value is to be. Section 11.7 contains a list of what effects the options have in HDFS. 8.8 *RUN fsp : : : This command loads and executes a file. The file is loaded to its' own load address, and executed at its' own execution address. The rest of the command line to *RUN is made available for the program to read through the OSARGS call. The file is first searched for in the current directory, and then in the current library if that fails. In HDFS, files can only be executed if they have execute permission set. Files on Acorn format catalogues can always be executed. As a special case, if the execution address is &FFFFFFFF, the file will be *EXECed instead of run. If a directory is *RUN, it will be made the current directory , and its' auto-boot options will be used to determine whether to look for a !BOOT file to load, run or *EXEC. 8.9 *SAVE fsp start (+) (exec (load)) Blocks of memory can be saved to files with this command. The memory to be saved is delimited by the hexadecimal start and end addresses. The execution address and load address of the file saved can be set by the optional exec and load ar guments. If the addresses to be saved are in I/O processor memory, and in the range &8000-&BFFF, the data is saved from the sideways ROM socket given by the value of *OPT 3. 8.10 *SPOOL (fsp) This command sends output to the screen to a disc file as well. It can be used to get a textual representation of almost anything that can be printed into a file. If no file specification is given, *SPOOLed output is turned off. In HDFS, filing system commands which produce output turn off *SPOOLed output, because of potential race conditions.