#include <libmc-common.h>

Include dependency graph for libmc.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	mcIcon

struct	_sceMcTblGetDir

struct	mcTable

struct	mcTable._create

struct	mcTable._modify

Macros
#define	MC_WAIT 0

#define	MC_NOWAIT 1

#define	MC_TYPE_PSX sceMcTypePS1

#define	MC_TYPE_PS2 sceMcTypePS2

#define	MC_TYPE_POCKET sceMcTypePDA

#define	MC_TYPE_NONE sceMcTypeNoCard

#define	MC_FORMATTED 1

#define	MC_UNFORMATTED 0

#define	MC_ATTR_READABLE sceMcFileAttrReadable

#define	MC_ATTR_WRITEABLE sceMcFileAttrWriteable

#define	MC_ATTR_EXECUTABLE sceMcFileAttrExecutable

#define	MC_ATTR_PROTECTED sceMcFileAttrDupProhibit

#define	MC_ATTR_FILE sceMcFileAttrFile

#define	MC_ATTR_SUBDIR sceMcFileAttrSubdir

#define	MC_ATTR_OBJECT (sceMcFileAttrFile\|sceMcFileAttrSubdir)

#define	MC_ATTR_CLOSED sceMcFileAttrClosed

#define	MC_ATTR_PDAEXEC sceMcFileAttrPDAExec

#define	MC_ATTR_PSX sceMcFileAttrPS1

#define	MC_ATTR_HIDDEN sceMcFileAttrHidden

#define	MC_TYPE_MC 0

#define	MC_TYPE_XMC 1

Typedefs
typedef int	iconIVECTOR[4]

typedef float	iconFVECTOR[4]

Enumerations
enum	MC_FUNC_NUMBERS { MC_FUNC_NONE = 0x00, MC_FUNC_GET_INFO, MC_FUNC_OPEN, MC_FUNC_CLOSE, MC_FUNC_SEEK, MC_FUNC_READ, MC_FUNC_WRITE, MC_FUNC_FLUSH = 0x0A, MC_FUNC_MK_DIR, MC_FUNC_CH_DIR, MC_FUNC_GET_DIR, MC_FUNC_SET_INFO, MC_FUNC_DELETE, MC_FUNC_FORMAT, MC_FUNC_UNFORMAT, MC_FUNC_GET_ENT, MC_FUNC_RENAME, MC_FUNC_CHG_PRITY, MC_FUNC_ERASE_BLOCK = 0x5A, MC_FUNC_READ_PAGE, MC_FUNC_WRITE_PAGE }

enum	MCICON_TYPES { MCICON_TYPE_SAVED_DATA = 0, MCICON_TYPE_SOFTWARE_PS2, MCICON_TYPE_SOFTWARE_PKT, MCICON_TYPE_SETTINGS_DATA, MCICON_TYPE_SYSTEM_DRIVER }

Functions
struct _sceMcTblGetDir	__attribute__ ((aligned(64)))

	aligned (64)))

int	mcInit (int type)

int	mcGetInfo (int port, int slot, int type, int free, int *format)

int	mcOpen (int port, int slot, const char *name, int mode)

int	mcClose (int fd)

int	mcSeek (int fd, int offset, int origin)

int	mcRead (int fd, void *buffer, int size)

int	mcWrite (int fd, const void *buffer, int size)

int	mcFlush (int fd)

int	mcMkDir (int port, int slot, const char *name)

int	mcChdir (int port, int slot, const char newDir, char currentDir)

int	mcGetDir (int port, int slot, const char name, unsigned mode, int maxent, sceMcTblGetDir table)

int	mcSetFileInfo (int port, int slot, const char name, const sceMcTblGetDir info, unsigned flags)

int	mcDelete (int port, int slot, const char *name)

int	mcFormat (int port, int slot)

int	mcUnformat (int port, int slot)

int	mcGetEntSpace (int port, int slot, const char *path)

int	mcRename (int port, int slot, const char oldName, const char newName)

int	mcEraseBlock (int port, int slot, int block, int mode)

int	mcReadPage (int port, int slot, unsigned int page, void *buffer)

int	mcWritePage (int port, int slot, int page, const void *buffer)

int	mcChangeThreadPriority (int level)

int	mcSync (int mode, int cmd, int result)

int	mcReset (void)

Variables
sceMcStDateTime	_Create

sceMcStDateTime	_Modify

u32	FileSizeByte

u16	AttrFile

u16	Reserve1

u32	Reserve2

u32	PdaAplNo

unsigned char	EntryName [32]

Detailed Description

Macros, structures & function prototypes for mclib.

Definition in file libmc.h.

Data Structure Documentation

◆ mcIcon

struct mcIcon

Definition at line 106 of file libmc.h.

Data Fields
unsigned char	head[4]	header = "PS2D"
unsigned short	type	filetype, used to be "unknown1" (see MCICON_TYPE_* above)
unsigned short	nlOffset	new line pos within title name
unsigned	unknown2	unknown
unsigned	trans	transparency
iconIVECTOR	bgCol[4]	background color for each of the four points
iconFVECTOR	lightDir[3]	directions of three light sources
iconFVECTOR	lightCol[3]	colors of each of these sources
iconFVECTOR	lightAmbient	ambient light
unsigned short	title[34]	application title - NOTE: stored in sjis, NOT normal ascii
unsigned char	view[64]	list icon filename
unsigned char	copy[64]	copy icon filename
unsigned char	del[64]	delete icon filename
unsigned char	unknown3[512]	unknown

◆ _sceMcTblGetDir

struct _sceMcTblGetDir

Definition at line 138 of file libmc.h.

Collaboration diagram for _sceMcTblGetDir:

Data Fields
sceMcStDateTime	_Create
sceMcStDateTime	_Modify
u32	FileSizeByte
u16	AttrFile
u16	Reserve1
u32	Reserve2
u32	PdaAplNo
unsigned char	EntryName[32]
char	EntryName[32]

◆ mcTable

struct mcTable

Definition at line 149 of file libmc.h.

Collaboration diagram for mcTable:

Data Fields
struct mcTable	_create
struct mcTable	_modify
unsigned	fileSizeByte	File size (bytes). For a directory entry: 0
unsigned short	attrFile	File attribute
unsigned short	unknown3
unsigned	unknown4[2]
unsigned char	name[32]	Entry name

◆ mcTable._create

struct mcTable._create

Definition at line 151 of file libmc.h.

Data Fields
unsigned char	unknown1
unsigned char	sec	Entry creation date/time (second)
unsigned char	min	Entry creation date/time (minute)
unsigned char	hour	Entry creation date/time (hour)
unsigned char	day	Entry creation date/time (day)
unsigned char	month	Entry creation date/time (month)
unsigned short	year	Entry creation date/time (year)

◆ mcTable._modify

struct mcTable._modify

Definition at line 168 of file libmc.h.

Data Fields
unsigned char	unknown2
unsigned char	sec	Entry modification date/time (second)
unsigned char	min	Entry modification date/time (minute)
unsigned char	hour	Entry modification date/time (hour)
unsigned char	day	Entry modification date/time (day)
unsigned char	month	Entry modification date/time (month)
unsigned short	year	Entry modification date/time (year)

Macro Definition Documentation

◆ MC_ATTR_OBJECT

#define MC_ATTR_OBJECT (sceMcFileAttrFile|sceMcFileAttrSubdir)

File or directory

Definition at line 57 of file libmc.h.

◆ MC_ATTR_HIDDEN

#define MC_ATTR_HIDDEN sceMcFileAttrHidden

not hidden in osdsys, but it is to games

Definition at line 62 of file libmc.h.

Enumeration Type Documentation

◆ MC_FUNC_NUMBERS

enum MC_FUNC_NUMBERS

function numbers returned by mcSync in the 'cmd' pointer

Definition at line 65 of file libmc.h.

◆ MCICON_TYPES

enum MCICON_TYPES

These types show up in the OSD browser when set. If the OSD doesn't know the number it'll display "Unrecognizable Data" or so. AFAIK these have no other effects. Known type IDs for icon.sys file:

Definition at line 95 of file libmc.h.

Function Documentation

◆ mcInit()

int mcInit ( int type )

init memcard lib

Parameters

type	Retained for backwards compatibility. Nominally specify MC_TYPE_MC.

Returns: 0 = successful; < 0 = error

Definition at line 230 of file libmc.c.

◆ mcGetInfo()

int mcGetInfo	(	int	port,
		int	slot,
		int *	type,
		int *	free,
		int *	format
	)

get memcard state mcSync result: 0 = same card as last getInfo call -1 = formatted card inserted since last getInfo call -2 = unformatted card inserted since last getInfo call < -2 = memcard access error (could be due to accessing psx memcard)

Parameters

port	port number
slot	slot number
type	pointer to get memcard type
free	pointer to get number of free clusters
format	pointer to get whether or not the card is formatted (Note: Originally, sceMcGetInfo didn't have a 5th argument for returning the format status. As this is emulated based on the return value of sceMcSync() when rom0:MCSERV is used, please keep track of the return value from sceMcSync instead!)

Returns: 0 = successful; < 0 = error

Definition at line 368 of file libmc.c.

◆ mcOpen()

int mcOpen	(	int	port,
		int	slot,
		const char *	name,
		int	mode
	)

open a file on memcard mcSync returns: 0 or more = file descriptor (success) < 0 = error

Parameters

port	port number
slot	slot number
name	filename to open
mode	open file mode (O_RDWR, O_CREAT, etc)

Returns: 0 = successful; < 0 = error

Definition at line 410 of file libmc.c.

◆ mcClose()

int mcClose ( int fd )

close an open file on memcard mcSync returns: 0 if closed successfully < 0 = error

Parameters

fd	file descriptor of open file

Returns: 0 successful; < 0 = error

Definition at line 435 of file libmc.c.

◆ mcSeek()

int mcSeek	(	int	fd,
		int	offset,
		int	origin
	)

move memcard file pointer mcSync returns: 0 or more = offset of file pointer from start of file < 0 = error

Parameters

fd	file descriptor
offset	number of bytes from origin
origin	initial position for offset

Returns: 0 = successful; < 0 = error

Definition at line 456 of file libmc.c.

◆ mcRead()

int mcRead	(	int	fd,
		void *	buffer,
		int	size
	)

read from file on memcard mcSync returns: 0 or more = number of bytes read from memcard < 0 = error

Parameters

fd	file descriptor
buffer	buffer to read to
size	number of bytes to read

Returns: 0 = successful; < 0 = error

Definition at line 479 of file libmc.c.

◆ mcWrite()

int mcWrite	(	int	fd,
		const void *	buffer,
		int	size
	)

write to file on memcard mcSync returns: 0 or more = number of bytes written to memcard < 0 = error

Parameters

fd	file descriptor
buffer	to write from write
size	number of bytes to read

Returns: 0 = successful; < 0 = error

Definition at line 505 of file libmc.c.

◆ mcFlush()

int mcFlush ( int fd )

flush file cache to memcard mcSync returns: 0 if ok < 0 if error

Parameters

fd	file descriptor

Returns: 0 = successful; < 0 = error

Definition at line 543 of file libmc.c.

◆ mcMkDir()

int mcMkDir	(	int	port,
		int	slot,
		const char *	name
	)

create a dir mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
name	directory name

Returns: 0 = successful; < 0 = error

Definition at line 564 of file libmc.c.

◆ mcChdir()

int mcChdir	(	int	port,
		int	slot,
		const char *	newDir,
		char *	currentDir
	)

change current dir (can also get current dir) mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
newDir	new dir to change to
currentDir	buffer to get current dir (use 0 if not needed)

Returns: 0 = successful; < 0 = error

Definition at line 573 of file libmc.c.

References g_currentCmd, and g_mclibInited.

◆ mcGetDir()

int mcGetDir	(	int	port,
		int	slot,
		const char *	name,
		unsigned	mode,
		int	maxent,
		sceMcTblGetDir *	table
	)

get memcard filelist mcSync result: 0 or more = number of file entries obtained (success) -2 = unformatted card -4 = dirname error

Parameters

port	port number of memcard
slot	slot number of memcard
name	filename to search for (can use wildcard and relative dirs)
mode	mode: 0 = first call, otherwise = followup call
maxext	maximum number of entries to be written to filetable in 1 call
table	mc table array

Returns: 0 = successful; < 0 = error

Definition at line 599 of file libmc.c.

◆ mcSetFileInfo()

int mcSetFileInfo	(	int	port,
		int	slot,
		const char *	name,
		const sceMcTblGetDir *	info,
		unsigned	flags
	)

change file information mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
name	filename to access
info	data to be changed
flags	flags to show which data is valid

Returns: 0 = successful; < 0 = error

Definition at line 627 of file libmc.c.

◆ mcDelete()

int mcDelete	(	int	port,
		int	slot,
		const char *	name
	)

delete file mcSync returns: 0 if deleted successfully < 0 if error

Parameters

port	port number to delete from
slot	slot number to delete from
name	filename to delete

Returns: 0 = successful; < 0 = error

Definition at line 656 of file libmc.c.

◆ mcFormat()

int mcFormat	(	int	port,
		int	slot
	)

format memory card mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number

Returns: 0 = success; -1 = error

Definition at line 681 of file libmc.c.

References g_currentCmd, and g_mclibInited.

◆ mcUnformat()

int mcUnformat	(	int	port,
		int	slot
	)

unformat memory card mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number

Returns: 0 = success; -1 = error

Definition at line 703 of file libmc.c.

References g_currentCmd, and g_mclibInited.

◆ mcGetEntSpace()

int mcGetEntSpace	(	int	port,
		int	slot,
		const char *	path
	)

get free space info mcSync returns: 0 or more = number of free entries (success) < 0 if error

Parameters

port	port number
slot	slot number
path	path to be checked

Returns: 0 or more = number of empty entries; -1 = error

Definition at line 725 of file libmc.c.

◆ mcRename()

int mcRename	(	int	port,
		int	slot,
		const char *	oldName,
		const char *	newName
	)

rename file or dir on memcard Note: rom0:MCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
oldName	name of file/dir to rename
newName	new name to give to file/dir

Returns: 1 = success; < 0 = error

Definition at line 749 of file libmc.c.

References g_mclibInited, and g_mcType.

◆ mcEraseBlock()

int mcEraseBlock	(	int	port,
		int	slot,
		int	block,
		int	mode
	)

Erases a block on the memory card. Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
block	Block number of the block to be erased.
mode	Mode: -1 to inhibit ECC recalculation of the erased block's pages (useful if sceMcWritePage is used to fill in its contents later on), 0 for normal operation.

Returns: 0 = success; -1 = error

Definition at line 778 of file libmc.c.

◆ mcReadPage()

int mcReadPage	(	int	port,
		int	slot,
		unsigned int	page,
		void *	buffer
	)

Reads a page from the memory card. Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
page	Page number of the page to be read.
buffer	Pointer to buffer that will contain the read data.

Returns: 0 = success; -1 = error

Definition at line 821 of file libmc.c.

◆ mcWritePage()

int mcWritePage	(	int	port,
		int	slot,
		int	page,
		const void *	buffer
	)

Writes a page to the memory card. (The block which the page resides on must be erased first!) Note: rom0:XMCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters

port	port number
slot	slot number
page	Page number of the page to be written.
buffer	Pointer to buffer containing data to be written.

Returns: 0 = success; -1 = error

Definition at line 846 of file libmc.c.

◆ mcChangeThreadPriority()

int mcChangeThreadPriority ( int level )

change mcserv thread priority (I don't think this is implemented properly) Note: rom0:MCSERV does not support this. mcSync returns: 0 if ok < 0 if error

Parameters

level thread priority

Returns: 0 = success; -1 = error

Definition at line 875 of file libmc.c.

References g_mclibInited, and g_mcType.

◆ mcSync()

int mcSync	(	int	mode,
		int *	cmd,
		int *	result
	)

wait for mc functions to finish or check if they have finished yet

Parameters

mode	mode 0=wait till function finishes, 1=check function status
cmd	pointer for storing the number of the currenlty processing function
result	pointer for storing result of function if it finishes

Returns: 0 = function is still executing (mode=1); 1 = function has finished executing; -1 = no function registered

Definition at line 898 of file libmc.c.

◆ mcReset()

int mcReset ( void )

Reset (force deinit) of library

Returns: 0 = success

Definition at line 940 of file libmc.c.

References g_mclibInited.

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Detailed Description

Data Structure Documentation

◆ mcIcon

◆ _sceMcTblGetDir

◆ mcTable

◆ mcTable._create

◆ mcTable._modify

Macro Definition Documentation

◆ MC_ATTR_OBJECT

◆ MC_ATTR_HIDDEN

Enumeration Type Documentation

◆ MC_FUNC_NUMBERS

◆ MCICON_TYPES

Function Documentation

◆ mcInit()

◆ mcGetInfo()

◆ mcOpen()

◆ mcClose()

◆ mcSeek()

◆ mcRead()

◆ mcWrite()

◆ mcFlush()

◆ mcMkDir()

◆ mcChdir()

◆ mcGetDir()

◆ mcSetFileInfo()

◆ mcDelete()

◆ mcFormat()

◆ mcUnformat()

◆ mcGetEntSpace()

◆ mcRename()

◆ mcEraseBlock()

◆ mcReadPage()

◆ mcWritePage()

◆ mcChangeThreadPriority()

◆ mcSync()

◆ mcReset()