SANE_NET_INIT

This RPC establishes a connection to a particular SANE network daemon. It must be the first call in a SANE network session. The parameter and reply arguments for this call are shown in the table below:

request:	reply:
SANE_Word version_code	SANE_Word status
SANE_String user_name	SANE_Word version_code

The version_code argument in the request is the SANE version-code of the network backend that is contacting the network daemon (see Section 4.1). The ``build-revision'' in the version code is used to hold the network protocol version. The SANE network daemon receiving such a request must make sure that the network protocol version corresponds to a supported version since otherwise the encoding of the network stream may be incompatible (even though the SANE interface itself may be compatible). The user_name argument is the name of the user on whose behalf this call is being performed. If the network backend cannot determine a user-name, it passes a NULL pointer for this argument. No trust should be placed in the authenticity of this user-name. The intent of this string is to provide more convenience to the user. E.g., it could be used as the default-user name in subsequent authentication calls.

In the reply, status indicates the completion status. If the value is anything other than SANE_STATUS_SUCCESS, the remainder of the reply has undefined values.^5.1 The version_code argument returns the SANE version-code that the network daemon supports. See the comments in the previous paragraph on the meaning of the build-revision in this version code.