Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Brew MP file system

Brew MP file system namespace begins with the string fs:/ and allows addressing of the entire Brew MP file system. This namespace allows applications to publish files for sharing with other applications without concern with namespace conflicts.

The following table describes the system directories in the Brew MP file system. The Default access column provides information on the default access allowed by system ACLs and the default access allowed when accessing a device over Diag. File system access using USB Gateway is controlled by ACLs. For more information on USB Gateway, see the Connect Technology Guide in http://developer.brewmp.com/resources on the Brew MP web site.

Path Description Default access

fs:/

File system root directory. Any application can initialize an enumerator on this directory, but the enumeration results depend on the current application permissions; mapping to / (the internal storage root directory) is recommended.

macro: AEEFS_ROOT_DIR

ACL: Enumeration.

Diag: Enumeration.

fs:/xxxxx

A file in the root directory.

ACL: AEEPRIVID_PFileSystemRW required for access.

Diag: Read.

fs:/~/

Current application module directory; if no application is active, this is fs:/sys/.

macro: AEEFS_HOME_DIR

ACL: Application has full access. No access for others unless the module allows access with ACLs/privileges.

Diag:

fs:/~0x0100F00D/

Module directory of the module that exports the ClassID 0x0100F00D.

Note: If 0x0100F00D is exported by module 333, and fs:/mod/333/ is module 333's home directory, this path is rewritten by Brew MP as fs:/mod/333/.

macro: Not applicable

ACL: No access unless the module allows access with ACLs/privileges.

Diag: Enumeration.

fs:/mod/

Module directory for the BDSMods collection.

macro: AEEFS_MOD_DIR

ACL: Enumeration.

Diag: Enumeration.

fs:/mod/nnn/, where nnn is a directory name consisting of digits only.

Module directory for a BDS monetized MIF.

ACL: Enumeration.

Diag: Create (no enumeration).

fs:/mod/nnn/xxxxx

File in a monetized module.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Create and write. Read is not allowed.

fs:/mod/nnn/private/

Module private directory.

ACL: No access unless module allows access with ACLs/privileges.

Diag: No access.

fs:/mod/abc/

Module directory for a non-monetized MIF.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Enumeration, delete, and create.

fs:/mod/abc/xxxxx

File in a non-monetized module.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Read, write, create, and delete.

fs:/mif/

MIF directory for the BDSMods collection.

macro: AEEFS_MIF_DIR

ACL: Enumeration.

Diag: Enumeration

fs:/mif/nnn.mif,

Monetized BDS MIF.

ACL: Read.

Diag: Create, write.

fs:/mif/abc.mif

Non-monetized BDS MIF, such as system or developer applications.

ACL: Read.

Diag: Read, write, create, delete

fs:/plazamods/

Directory for Plaza Global modules.

ACL: Enumeration.

Diag: Enumeration, delete, and create.

fs:/plazamods/abc/

Plaza Global module directory.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Enumeration, delete, and create.

fs:/plazamods/abc/xxxxx

File in a Plaza Global module directory.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Enumeration, delete, and create.

fs:/sys/

The system directory.

ACL: Enumeration, delete, and create.

Diag: Enumeration, delete, and create.

fs:/sys/mod/

Directory for system modules.

macro: AEEFS_SYS_DIR/mod

ACL: Enumeration.

Diag: Enumeration, delete, and create.

fs:/sys/mod/yyy/

Directory for a system module named yyy.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Enumeration, delete, and create.

fs:/sys/mod/yyy/xxxxx

A file in the module directory for the yyy module.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Read, write, create, and delete.

fs:/sys/xxxxx

A file in the system directory.

ACL: Read.

Diag: Read, write, create, and delete.

fs:/sys/dir/

A directory in the system directory.

ACL: Enumeration.

Diag: Enumeration, delete, and create.

fs:/sys/priv/

The private system directory.

ACL: AEEPRIVID_PFileSystemRW required for access.

Diag: No access.

fs:/sys/download/

BDS files and directories.

ACL: AEEPRIVID_PLDownload required for enumeration, read, write, create, and delete.

Diag: No access.

fs:/usermods/

Root directory for the UserMods collection.

macro: Not applicable

ACL: Enumeration.

Diag: Enumeration, delete, and create.

fs:/usermods/abc/

Module directory in the UserMods collection.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Enumeration, delete, and create.

fs:/usermods/abc/xxxxx

File in a module directory.

ACL: No access unless module allows access with ACLs/privileges.

Diag: Read, write, create, and delete.

fs:/shared/

Shared directory. Files in this directory are shared with all applications.

Note: Use of fs:/shared/ is not recommended. fs:/shared/ does not have ACLs to control access. In addition, files are automatically deleted when the owning application is deleted. In Brew 3.1.5 and Brew MP, applications should use MCF to share files. For more information, see Multimedia Content File (MCF).

macro: AEEFS_SHARED_DIR

ACL: Enumeration. AEEPRIVID_PLSharedWrite privilege required for write access.

Diag: Enumeration, delete, create.

fs:/shared/xxxxx

Files in fs:/shared/.

ACL: Read, create, and delete. AEEPRIVID_PLSharedWrite is required for write access.

Diag: Read, write, create, and delete.

fs:/shared/xxxdir

Directories in fs:/shared/.

ACL: Read. AEEPRIVID_PLSharedWrite is required for write, create, and delete access.

Diag: Enumeration, delete, and create.

fs:/ringers/

Ringer storage directory.

macro: AEEFS_RINGERS_DIR

ACL: Enumeration.

Diag: No access.

fs:/ringers/xxxxx

A file in the ringer directory.

ACL: AEEPRIVID_PLRinger privilege required for access.

Diag: No access.

fs:/address/

Legacy directory for IADDRBOOK database. Unused in Brew MP.

macro: AEEFS_ADDRESS_DIR

ACL: Enumeration.

Diag: Enumeration, create, and delete.

fs:/address/xxxxx

A file in the IADDRBOOK directory.

ACL: AEEPRIVID_PLAddrBook privilege required for access.

Diag: Read, write, create, and delete.

fs:/card0/

First removable memory card (RMC); if the RMC is removed, any access to this path returns a failure with the error code ENOMEDIA.

macro: AEEFS_CARD0_DIR

ACL: AEECLSID_CARD0_ACCESS privilege required for access.

Diag: