API for interacting with the Point-to-Point Protocol stack More...

Topics
	Automaton Phases
	PPP automaton phases

	Configuration Flags
	PPP link configuration flags

Files
file	ppp.h
	PPP interface for network communications.

Data Structures
struct	ppp_device_t
	PPP device structure. More...

struct	ppp_protocol_t
	PPP Protocol structure. More...

Macros
#define	PPP_TX_END_OF_PKT 0x00000001
	End of packet flag.

#define	PPP_PROTO_ENTRY_INIT { NULL, NULL }
	Static initializer for protocol list entry.

Functions
int	ppp_set_device (ppp_device_t *dev)
	Set the device used to do PPP communications.

int	ppp_set_login (const char username, const char password)
	Set the login credentials used to authenticate to the peer.

int	ppp_send (const uint8_t *data, size_t len, uint16_t proto)
	Send a packet on the PPP link.

int	ppp_add_protocol (ppp_protocol_t *hnd)
	Register a protocol with the PPP stack.

int	ppp_del_protocol (ppp_protocol_t *hnd)
	Unregister a protocol from the PPP stack.

int	ppp_lcp_send_proto_reject (uint16_t proto, const uint8_t *pkt, size_t len)
	Send a Protocol Reject packet on the link.

uint32_t	ppp_get_flags (void)
	Get the flags set for our side of the link.

uint32_t	ppp_get_peer_flags (void)
	Get the flags set for the peer's side of the link.

void	ppp_set_flags (uint32_t flags)
	Set the flags set for our side of the link.

int	ppp_connect (void)
	Establish a point-to-point link across a previously set-up device.

int	ppp_scif_init (int bps)
	Initialize the Dreamcast serial port for a PPP link.

int	ppp_modem_init (const char number, int blind, int conn_rate)
	Initialize the Dreamcast modem for a PPP link.

int	ppp_init (void)
	Initialize the PPP library.

int	ppp_shutdown (void)
	Shut down the PPP library.

Detailed Description

API for interacting with the Point-to-Point Protocol stack

Macro Definition Documentation

◆ PPP_PROTO_ENTRY_INIT

#define PPP_PROTO_ENTRY_INIT { NULL, NULL }

Static initializer for protocol list entry.

◆ PPP_TX_END_OF_PKT

#define PPP_TX_END_OF_PKT 0x00000001

End of packet flag.

Function Documentation

◆ ppp_add_protocol()

int ppp_add_protocol ( ppp_protocol_t * hnd )

Register a protocol with the PPP stack.

This function adds a new protocol to the PPP stack, allowing the stack to communicate packets for the given protocol across the link. Generally, you should not have any reason to call this function, as the library includes a set of protocols to do normal communications.

Parameters

hnd	A protocol handler structure.

Returns: 0 on success, <0 on failure.

◆ ppp_connect()

int ppp_connect ( void )

Establish a point-to-point link across a previously set-up device.

This function establishes a point-to-point link to the peer across a device that was previously set up with ppp_set_device(). Before calling this function, the device must be ready to communicate with the peer. That is to say, any handshaking needed to establish the underlying hardware link must have already completed.

Returns: 0 on success, <0 on failure.

Note: This function will block until the link is established.

◆ ppp_del_protocol()

int ppp_del_protocol ( ppp_protocol_t * hnd )

Unregister a protocol from the PPP stack.

This function removes protocol from the PPP stack. This should be done at shutdown time of any protocols added with ppp_add_protocol().

Parameters

hnd	A protocol handler structure.

Returns: 0 on success, <0 on failure.

◆ ppp_get_flags()

uint32_t ppp_get_flags ( void )

Get the flags set for our side of the link.

This function retrieves the connection flags set for our side of the PPP link. Before link establishment, this indicates the flags we would like to establish on the link and after establishment it represents the flags that were actually negotiated during link establishment.

Returns: Bitwise OR of Configuration Flags.

◆ ppp_get_peer_flags()

uint32_t ppp_get_peer_flags ( void )

Get the flags set for the peer's side of the link.

This function retrieves the connection flags set for the other side of the PPP link. This value is only valid after link establishment.

Returns: Bitwise OR of Configuration Flags.

◆ ppp_init()

int ppp_init ( void )

Initialize the PPP library.

This function initializes the PPP library, preparing internal structures for use and initializing the PPP protocols needed for normal IP communications.

Returns: 0 on success, <0 on failure.

◆ ppp_lcp_send_proto_reject()

int ppp_lcp_send_proto_reject	(	uint16_t	proto,
		const uint8_t *	pkt,
		size_t	len )

Send a Protocol Reject packet on the link.

This function sends a LCP protocol reject packet on the link for the specified packet. Generally, you should not have to call this function, as the library will handle doing so internally.

Parameters

proto	The PPP protocol number of the invalid packet.
pkt	The packet itself.
len	The length of the packet, in bytes.

Returns: 0 on success, <0 on failure.

◆ ppp_modem_init()

int ppp_modem_init	(	const char *	number,
		int	blind,
		int *	conn_rate )

Initialize the Dreamcast modem for a PPP link.

This function sets up the Dreamcast modem to act as a communications link for a point-to-point connection. This includes dialing the specified phone number and establishing the low-level link.

Parameters

number	The phone number to dial out.
blind	Non-zero to blind dial (don't wait for a dial tone).
conn_rate	Storage for the connection rate, in bits per second. Set to NULL if you do not need this value back from the function.

Return values

0	On success.
-1	If modem initialization fails.
-2	If not using blind dial and no dial tone is detected within 5 seconds of opening the line.
-3	If dialing the modem fails.
-4	If a connection is not established in 60 seconds after dialing.

◆ ppp_scif_init()

int ppp_scif_init ( int bps )

Initialize the Dreamcast serial port for a PPP link.

This function sets up the Dreamcast serial port to act as a communications link for a point-to-point connection. This can be used in conjunction with a coder's cable (or similar) to connect the Dreamcast to a PC and the internet if the target system is set up properly.

Parameters

bps	The speed to initialize the serial port at.

Returns: 0 on success, <0 on failure.

◆ ppp_send()

int ppp_send	(	const uint8_t *	data,
		size_t	len,
		uint16_t	proto )

Send a packet on the PPP link.

This function sends a single packet to the peer on the PPP link. Generally, you should not use this function directly, but rather use the facilities provided by KOS' network stack.

Parameters

data	The packet to send.
len	The length of the packet, in bytes.
proto	The PPP protocol number for the packet.

Returns: 0 on success, <0 on failure.

◆ ppp_set_device()

int ppp_set_device ( ppp_device_t * dev )

Set the device used to do PPP communications.

This function sets the device that further communications over a point-to-point link will take place over. The device need not be ready to communicate immediately upon calling this function.

Unless you are adding support for a new device, you will probably never have to call this function. For instance, if you want to use the Dreamcast serial port to establish a link, the ppp_scif_init() function will call this for you.

Warning: Calling this function after establishing a PPP link will fail.

Parameters

dev	The device to use for communication.

Returns: 0 on success, <0 on failure.

◆ ppp_set_flags()

void ppp_set_flags ( uint32_t flags )

Set the flags set for our side of the link.

Parameters

flags Bitwise combination of Configuration Flags.

This function sets the connection flags for our side of the PPP link.

◆ ppp_set_login()

int ppp_set_login	(	const char *	username,
		const char *	password )

Set the login credentials used to authenticate to the peer.

This function sets the login credentials that will be used to authenticate to the peer, if the peer requests authentication. The specifics of how the authentication takes place depends on what options are configured when establishing the link.

Warning: Calling this function after establishing a PPP link will fail.

Parameters

username	The username to authenticate as.
password	The password to use to authenticate.

Returns: 0 on success, <0 on failure.

◆ ppp_shutdown()

int ppp_shutdown ( void )

Shut down the PPP library.

This function cleans up the PPP library, shutting down any connections and deinitializing any protocols that have bene registered previously.

Returns: 0 on success, <0 on failure.

Topics

Files

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ PPP_PROTO_ENTRY_INIT

◆ PPP_TX_END_OF_PKT

Function Documentation

◆ ppp_add_protocol()

◆ ppp_connect()

◆ ppp_del_protocol()

◆ ppp_get_flags()

◆ ppp_get_peer_flags()

◆ ppp_init()

◆ ppp_lcp_send_proto_reject()

◆ ppp_modem_init()

◆ ppp_scif_init()

◆ ppp_send()

◆ ppp_set_device()

◆ ppp_set_flags()

◆ ppp_set_login()

◆ ppp_shutdown()