| 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.
 
 
 
 |