# FS_Init

## C Specification

      #include <nitro/fs.h>

      void FS_Init( u32 default_dma_no );

## Description

This function initializes the ROM file system.

It performs the following processes:

- Sets the current directory to ROM archive root ("`rom:/`").
- Initializes the DMA number that the ROM archive uses.

## Caution

When a valid DMA channel is specified, this DMA channel cannot be used until the setting is changed with the `FS_SetDefaultDMA` function.

The file system uses this DMA channel internally to access the NITRO ROM device.

Refer to the description on the `CARD_ReadRom` function and `CARD_ReadRomAsync` functions.

## Arguments

`default_dma_no` | DMA number that the ROM Archive in the file system uses. If you specify `FS_DMA_NOT_USE`, instead of DMA, it uses the CPU to transfer. When a valid DMA channel is specified, this DMA channel cannot be used until the setting is changed with the `FS_SetDefaultDMA` function.

## Return Values

None.

## See Also

`FS_DMA_NOT_USE`, `FS_IsAvailable`, `FS_SetDefaultDMA`, `CARD_ReadRom`, `CARD_ReadRomAsync`

## Revision History

09/24/2004 Fixed links 07/23/2004 Added caution regarding the ROM archive and DMA channel
05/14/2004 Added description concerning `FS_DMA_NOT_USE`
04/13/2004 Added a reference to the `FS_IsAvailable` function
04/08/2004 Revised description due to the addition of DMA number specification
04/02/2004 Changed "file system" to "ROM file system"
04/01/2004 Initial version