ham_connect()

Arguments:

flags

Currently not used.

Library:

libham

Description:

The ham_connect() function initializes a connection to a HAM.

You can call this function any number of times, but because the library maintains a reference count, you need to call ham_disconnect() the same number of times to release the connection.

Connections are associated with a specific process ID (pid). If a process performs ham_connect() and then calls fork(), the child process needs to reconnect to the HAM by calling ham_connect() again.

But if a process only calls any of the following:

• ham_attach_self()
• ham_attach()
• ham_detach()
• ham_detach_self()
• ham_detach_name()
• ham_stop()
• ham_entity()
• ham_verbose()

it doesn't need to call ham_connect(), since those functions create their own temporary connection.

There are no flags defined at this time.

Returns:

0

Success.

-1

An error occurred (errno is set).

Errors:

Upon failure, the ham_connect() function returns the error as set by the underlying open() library call that failed.

Classification:

QNX OS