06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

k_terminate pSOS+ <strong>System</strong> <strong>Calls</strong><br />

k_terminate Terminates a node other than the master node.<br />

unsigned long k_terminate (<br />

unsigned long node, /* node to terminate */<br />

unsigned long fcode, /* failure code */<br />

unsigned long flags /* unused */<br />

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

This system call enables the user application to shut down a node that it believes<br />

has failed or is operating incorrectly. k_terminate() causes the specified node to<br />

receive a shutdown packet and all other nodes to receive notification of the specified<br />

node's failure.<br />

node Specifies the node number of the node to shut down. It<br />

cannot be the master node.<br />

fcode Specifies a user-defined failure code. It must be at least<br />

0x20000000.<br />

flags Unused.<br />

This system returns 0 on success or an error code on failure.<br />

Hex Mnemonic Description<br />

0x04 ERR_NODENO Node number out of range.<br />

0x67 ERR_MASTER Cannot terminate master node.<br />

1-42 <strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!