Function silc_client_file_receive
SYNOPSIS
SilcClientFileError
silc_client_file_receive(SilcClient client,
SilcClientConnection conn,
SilcClientConnectionParams *params,
SilcPublicKey public_key,
SilcPrivateKey private_key,
SilcClientFileMonitor monitor,
void *monitor_context,
const char *path,
SilcUInt32 session_id,
SilcClientFileAskName ask_name,
void *ask_name_context);
DESCRIPTION
Receives a file from a client indicated by the `client_entry'. The
`session_id' indicates the file transmission session and it has been
received in the `ftp' client operation callback. This will actually
perform the key agreement protocol with the remote client before
actually starting the file transmission. The `monitor' callback
will be called to monitor the transmission. If `path' is non-NULL
the file will be saved into that directory. If NULL the file is
saved in the current working directory, unless the 'ask_name'
callback is non-NULL. In this case the callback is called to ask
the path and filename from application.
The `params' is the connection related parameters. If the remote client
provided connection point the `params' will be used when creating
connection to the remote client. If remote client did not provide
connection point the `params' is used to provide connection point
locally for the remote client. See silc_client_file_send for more
information on providing connection point for remote client.
The `public_key' and `private_key' is our identity in the key agreement.
If error will occur during the file transfer process the error status
will be returned in the monitor callback. In this case the application
must call silc_client_file_close to close the session.
|