Safeguarding the past, present and future of RISC OS for everyone

OS_FSControl (changes)

Showing changes from revision #6 to #7: Added | ~~Removed~~ | ~~Chan~~ged

Programmer's OS Reference SWI Manuals Calls

» OS_FSControlPart 15 – SWI Calls

~~» OS~~
~~» OS_FSControl~~

OS_FSControl

(SWI &29)

Entry
R0	Reason code
Other registers dependent on reason code

Exit
R0	Preserved
Other registers dependent on reason code

Use

The purpose of this call is control the filing system manager and the filing system themselves.

Notes

The action performed depends on the reason code value in R0.

Reason Codes

#	Hex #	Action
0	&00	Set current dir
1	&01	Set library dir
2	&02	Inform of start of new app
3	&03	Run Type (Internal use only)
4	&04	Run a file
5	&05	Catalogue a dir
6	&06	Examine current dir
7	&07	Catalogue library
8	&08	Examine library
9	&09	Examine objects
10	&0A	Set FS options
11	&0B	Set temporary FS
12	&0C	Add a FS
13	&0D	Check for FS
14	&0E	Select FS
15	&0F	Boot from FS
16	&10	Remove FS
17	&11	Add secondary module
18	&12	Convert filetype number to name
19	&13	Restore current FS
20	&14	Read location of temp FS
21	&15	Return a file handle
22	&16	Close all open files
23	&17	Shutdown FS
24	&18	Set attributes of objects
25	&19	Rename object
26	&1A	Copy objects
27	&1B	Wipe objects
28	&1C	Count objects
29	&1D	Create Handle (Internal use only)
30	&1E	Read location of temporary FS secondary module
31	&1F	Convert filetype name to number
32	&20	Output list of object names & info
33	&21	Convert a filing system number to a name
34	&22	Set Contexts (Reserved)
35	&23	Add an image FS
36	&24	Remove an image FS
37	&25	Canonicalise path
38	&26	Extract filetype from file information
39	&27	Set User Root Directory
40	&28	Swap current and previous directories
41	&29	Return defect list for an image file
42	&2A	Map out defect from an image file
43	&2B	Unset the Current Directory
44	&2C	Unset the User Root Directory
45	&2D	Unset the Library Directory
46	&2E	Return used space map of image file
47	&2F	Read boot option for disc or image file
48	&30	Write boot option for disc or image file
49	&31	Read free space for disc or image file
50	&32	Rename disc or image file
51	&33	Request update of image stamp
52	&34	Find object at offset within image file
53	&35	Set given directory to path unchecked
54	&36	Read path of given directory
55	&37	Read free space for a large disc or image file
56	&38	Read defect list for a large disc or image file
57	&39	Map out defect from large disc or image
58	&3A	Enumerate file handles

Search the Wiki

Social

and

ROOL Store

Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.

Donate! Why?

Help ROOL make things happen – please consider donating!

RISC OS IPR

RISC OS is an Open Source operating system owned by RISC OS Developments Ltd and licensed primarily under the Apache 2.0 license.