Registry Kernel Library

Data Structures
struct	RegParam
	Struct used to open a registry. More...

Macros
#define	SYSTEM_REGISTRY   "/system"
	System registry path.
#define	REG_KEYNAME_SIZE   27
	Size of a keyname, used in sceRegGetKeys.

Typedefs
typedef unsigned int	REGHANDLE
	Typedef for a registry handle.

Enumerations
enum	RegKeyTypes { REG_TYPE_DIR = 1 , REG_TYPE_INT = 2 , REG_TYPE_STR = 3 , REG_TYPE_BIN = 4 }
	Key types. More...

Functions
int	sceRegOpenRegistry (struct RegParam *reg, int mode, REGHANDLE *h)
	Open the registry.
int	sceRegFlushRegistry (REGHANDLE h)
	Flush the registry to disk.
int	sceRegCloseRegistry (REGHANDLE h)
	Close the registry.
int	sceRegOpenCategory (REGHANDLE h, const char *name, int mode, REGHANDLE *hd)
	Open a registry directory.
int	sceRegRemoveCategory (REGHANDLE h, const char *name)
	Remove a registry dir.
int	sceRegCloseCategory (REGHANDLE hd)
	Close the registry directory.
int	sceRegFlushCategory (REGHANDLE hd)
	Flush the registry directory to disk.
int	sceRegGetKeyInfo (REGHANDLE hd, const char *name, REGHANDLE *hk, unsigned int *type, SceSize *size)
	Get a key's information.
int	sceRegGetKeyInfoByName (REGHANDLE hd, const char *name, unsigned int *type, SceSize *size)
	Get a key's information by name.
int	sceRegGetKeyValue (REGHANDLE hd, REGHANDLE hk, void *buf, SceSize size)
	Get a key's value.
int	sceRegGetKeyValueByName (REGHANDLE hd, const char *name, void *buf, SceSize size)
	Get a key's value by name.
int	sceRegSetKeyValue (REGHANDLE hd, const char *name, const void *buf, SceSize size)
	Set a key's value.
int	sceRegGetKeysNum (REGHANDLE hd, int *num)
	Get number of subkeys in the current dir.
int	sceRegGetKeys (REGHANDLE hd, char *buf, int num)
	Get the key names in the current directory.
int	sceRegCreateKey (REGHANDLE hd, const char *name, int type, SceSize size)
	Create a key.
int	sceRegRemoveRegistry (struct RegParam *reg)
	Remove a registry (HONESTLY, DO NOT USE)

Detailed Description

Macro Definition Documentation

REG_KEYNAME_SIZE

#define REG_KEYNAME_SIZE   27

Size of a keyname, used in sceRegGetKeys.

SYSTEM_REGISTRY

#define SYSTEM_REGISTRY   "/system"

System registry path.

Typedef Documentation

REGHANDLE

typedef unsigned int REGHANDLE

Typedef for a registry handle.

Enumeration Type Documentation

RegKeyTypes

enum RegKeyTypes

Key types.

Enumerator
REG_TYPE_DIR	Key is a directory.
REG_TYPE_INT	Key is an integer (4 bytes)
REG_TYPE_STR	Key is a string.
REG_TYPE_BIN	Key is a binary string.

Function Documentation

sceRegCloseCategory()

int sceRegCloseCategory

(

REGHANDLE

hd

)

Close the registry directory.

Parameters

hd	- The open registry dir handle

Returns

0 on success, < 0 on error

sceRegCloseRegistry()

int sceRegCloseRegistry

(

REGHANDLE

h

)

Close the registry.

Parameters

h	- The open registry handle

Returns

0 on success, < 0 on error

sceRegCreateKey()

int sceRegCreateKey	(	REGHANDLE	hd,
		const char *	name,
		int	type,
		SceSize	size
	)

Create a key.

Parameters

hd	- The open registry dir handle
name	- Name of the key to create
type	- Type of key (note cannot be a directory type)
size	- Size of the allocated value space

Returns

0 on success, < 0 on error

sceRegFlushCategory()

int sceRegFlushCategory

(

REGHANDLE

hd

)

Flush the registry directory to disk.

Parameters

hd	- The open registry dir handle

Returns

0 on success, < 0 on error

sceRegFlushRegistry()

int sceRegFlushRegistry

(

REGHANDLE

h

)

Flush the registry to disk.

Parameters

h	- The open registry handle

Returns

0 on success, < 0 on error

sceRegGetKeyInfo()

int sceRegGetKeyInfo	(	REGHANDLE	hd,
		const char *	name,
		REGHANDLE *	hk,
		unsigned int *	type,
		SceSize *	size
	)

Get a key's information.

Parameters

hd	- The open registry dir handle
name	- Name of the key
hk	- Pointer to a REGHANDLE to get registry key handle
type	- Type of the key, on of RegKeyTypes
size	- The size of the key's value in bytes

Returns

0 on success, < 0 on error

sceRegGetKeyInfoByName()

int sceRegGetKeyInfoByName	(	REGHANDLE	hd,
		const char *	name,
		unsigned int *	type,
		SceSize *	size
	)

Get a key's information by name.

Parameters

hd	- The open registry dir handle
name	- Name of the key
type	- Type of the key, on of RegKeyTypes
size	- The size of the key's value in bytes

Returns

0 on success, < 0 on error

sceRegGetKeys()

int sceRegGetKeys	(	REGHANDLE	hd,
		char *	buf,
		int	num
	)

Get the key names in the current directory.

Parameters

hd	- The open registry dir handle
buf	- Buffer to hold the NUL terminated strings, should be num*REG_KEYNAME_SIZE
num	- Number of elements in buf

Returns

0 on success, < 0 on error

sceRegGetKeysNum()

int sceRegGetKeysNum	(	REGHANDLE	hd,
		int *	num
	)

Get number of subkeys in the current dir.

Parameters

hd	- The open registry dir handle
num	- Pointer to an integer to receive the number

Returns

0 on success, < 0 on error

sceRegGetKeyValue()

int sceRegGetKeyValue	(	REGHANDLE	hd,
		REGHANDLE	hk,
		void *	buf,
		SceSize	size
	)

Get a key's value.

Parameters

hd	- The open registry dir handle
hk	- The open registry key handler (from sceRegGetKeyInfo)
buf	- Buffer to hold the value
size	- The size of the buffer

Returns

0 on success, < 0 on error

sceRegGetKeyValueByName()

int sceRegGetKeyValueByName	(	REGHANDLE	hd,
		const char *	name,
		void *	buf,
		SceSize	size
	)

Get a key's value by name.

Parameters

hd	- The open registry dir handle
name	- The key name
buf	- Buffer to hold the value
size	- The size of the buffer

Returns

0 on success, < 0 on error

sceRegOpenCategory()

int sceRegOpenCategory	(	REGHANDLE	h,
		const char *	name,
		int	mode,
		REGHANDLE *	hd
	)

Open a registry directory.

Parameters

h	- The open registry handle
name	- The path to the dir to open (e.g. /CONFIG/SYSTEM)
mode	- Open mode (can be 1 or 2, probably read or read/write
hd	- Pointer to a REGHANDLE to receive the registry dir handle

Returns

0 on success, < 0 on error

sceRegOpenRegistry()

int sceRegOpenRegistry	(	struct RegParam *	reg,
		int	mode,
		REGHANDLE *	h
	)

Open the registry.

Parameters

reg	- A filled in RegParam structure
mode	- Open mode (set to 1)
h	- Pointer to a REGHANDLE to receive the registry handle

Returns

0 on success, < 0 on error

sceRegRemoveCategory()

int sceRegRemoveCategory	(	REGHANDLE	h,
		const char *	name
	)

Remove a registry dir.

Parameters

h	- The open registry dir handle
name	- The name of the key

Returns

0 on success, < 0 on error

sceRegRemoveRegistry()

int sceRegRemoveRegistry

(

struct RegParam *

reg

)

Remove a registry (HONESTLY, DO NOT USE)

Parameters

reg	- Filled out registry parameter

Returns

0 on success, < 0 on error

sceRegSetKeyValue()

int sceRegSetKeyValue	(	REGHANDLE	hd,
		const char *	name,
		const void *	buf,
		SceSize	size
	)

Set a key's value.

Parameters

hd	- The open registry dir handle
name	- The key name
buf	- Buffer to hold the value
size	- The size of the buffer

Returns

0 on success, < 0 on error