Copyright © 2001 - 2005 SILC Project SILC Project Website | SILC Toolkit Reference Manual Index

SILC Toolkit Reference Manual
SILC Core Library
SILC Authentication Interface
SILC Message Interface
SILC Channel Interface
SILC Command Interface
SILC Notify Interface
SILC Status Types
SILC Modes
SILC ID Interface
SILC ID Cache Interface
SILC Argument Interface
SILC Attributes Interface
Packet Protocol Interface
SILC Utility Library
Basic SILC Types
SILC Buffer Interface
SILC Buffer Format Interface
SILC Hash Table Interface
SILC Logging Interface
SILC Memory Interface
SILC Mutex Interface
SILC Thread Interface
SILC Network Interface
SILC Schedule Interface
SILC Socket Interface
SILC Protocol Interface
SILC Config Interface
SILC File Util Interface
SILC String Util Interface
SILC UTF-8 Interface
SILC Stringprep Interface
SILC Util Interface
SILC List Interface
SILC Dynamic List Interface
SILC VCard Interface
SILC Application Utilities
SILC MIME Interface
SILC Crypto Library
Introduction to SILC RNG
SILC RNG Interface
SILC Cipher API
SILC PKCS API
SILC PKCS#1 API
SILC Hash Interface
SILC HMAC Interface
SILC SFTP Library
SILC SFTP Interface
SFTP Filesystems Interface
SILC Client Library
Using SILC Client Library Tutorial
Arguments for command_reply Client Operation
SilcStatus Error Arguments in command_reply Client Operation
Arguments for notify Client Operation
Unicode and UTF-8 Strings in Client Library
Client Library Interface Reference
SILC Key Exchange Library
SILC SKE Interface
SKE Status Types
SKE Diffie Hellman Groups
SKE Payloads
SILC Math Library
SILC MP Interface
SILC Math Interface
Resource Links
SILC Project Website
SILC Protocol Documentation
SILC White Paper
SILC FAQs

Structure SilcClientParams
NAME

        typedef struct { ... } SilcClientParams;

DESCRIPTION

        Client parameters. This can be filled with proper values and
        given as argument to the silc_client_alloc function. The structure
        hold various parameters which affects the function of the client.

SOURCE

        typedef struct {
          /* Number of maximum tasks the client library's scheduler can handle.
             If set to zero, the default value will be used (200). For WIN32
             systems this should be set to 64 as it is the hard limit dictated
             by the WIN32. */
          int task_max;

          /* Rekey timeout in seconds. The client will perform rekey in this
             time interval. If set to zero, the default value will be used. */
          unsigned int rekey_secs;

          /* Connection authentication method request timeout. If server does not
             reply back the current authentication method when we've requested it
             in this time interval we'll assume the reply will not come at all.
             If set to zero, the default value (2 seconds) will be used. */
          unsigned int connauth_request_secs;

          /* Nickname format string. This can be used to order the client library
             to save the nicknames in the library in a certain format. Since
             nicknames are not unique in SILC it is possible to have multiple same
             nicknames. Using this format string it is possible to order the library
             to separate the multiple same nicknames from each other. The format
             types are defined below and they can appear in any order in the format
             string. If this is NULL then default format is used which is the
             default nickname without anything else. The string MUST be NULL
             terminated.

             Following format types are available:

             %n  nickname      - the real nickname returned by the server (mandatory)
             %h  hostname      - the stripped hostname of the client
             %H  full hostname - the full hostname of the client
             %s  server name   - the server name the client is connected
             %S  full server   - the full server name the client is connected
             %a  number        - ascending number in case there are several
                                 same nicknames (fe. nick@host and nick@host2)

             Example format strings: "%n@%h%a"   (fe. nick@host, nick@host2)
                                     "%a!%n@%s"  (fe. nick@server, 2!nick@server)
                                     "%n@%H"     (fe. nick@host.domain.com)

             By default this format is employed to the nicknames by the libary
             only when there appears multiple same nicknames. If the library has
             only one nickname cached the nickname is saved as is and without the
             defined format. If you want always to save the nickname in the defined
             format set the boolean field `nickname_force_format' to value TRUE.
          */
          char nickname_format[32];

          /* If this is set to TRUE then the `nickname_format' is employed to all
             saved nicknames even if there are no multiple same nicknames in the
             cache. By default this is FALSE, which means that the `nickname_format'
             is employed only if the library will receive a nickname that is
             already saved in the cache. It is recommended to leave this to FALSE
             value. */
          bool nickname_force_format;

          /* A callback function provided by the application for the library to
             parse the nickname from the formatted nickname string. Even though
             the libary formats the nicknames the application knows generally the
             format better so this function should be provided for the library
             if the application sets the `nickname_format' field. The library
             will call this to get the true nickname from the provided formatted
             nickname string whenever it needs the true nickname. */
          SilcNicknameFormatParse nickname_parse;

          /* If this is set to TRUE then the client will ignore all incoming
             Requested Attributes queries and does not reply anything back.  This
             usually leads into situation where server does not anymore send
             the queries after seeing that client does not reply anything back.
             If your application does not support Requested Attributes or you do
             not want to use them set this to TRUE.  See SilcAttribute and
             silc_client_attribute_add for more information on attributes. */
          bool ignore_requested_attributes;

          /* If this is set to TRUE, the silcclient library will not register and
             deregister the cipher, pkcs, hash and hmac algorithms. The application
             itself will need to handle that. */
          bool dont_register_crypto_library;

        } SilcClientParams;

Client Library Interface
SilcClient
SilcClientConnection
SilcClientEntry
SilcChannelEntry
SilcChannelUser
SilcServerEntry
SilcKeyAgreementStatus
SilcKeyAgreementCallback
SilcPrivateMessageKeys
SilcChannelPrivateKey
SilcAskPassphrase
SilcVerifyPublicKey
SilcGetAuthMeth
SilcClientMessageType
SilcClientConnectionStatus
SilcClientOperations
SilcNicknameFormatParse
SilcClientParams
silc_client_alloc
silc_client_free
silc_client_init
silc_client_run
silc_client_run_one
silc_client_stop
SilcClientConnectionParams
silc_client_connect_to_server
silc_client_add_connection
silc_client_del_connection
silc_client_add_socket
silc_client_del_socket
silc_client_start_key_exchange
silc_client_close_connection
silc_client_send_channel_message
silc_client_send_private_message
SilcGetClientCallback
silc_client_get_clients
silc_client_get_clients_whois
silc_client_get_clients_local
silc_client_get_clients_by_channel
silc_client_get_clients_by_list
silc_client_get_client_by_id
silc_client_get_client_by_id_resolve
silc_client_del_client
SilcGetChannelCallback
silc_client_get_channel
silc_client_get_channel_resolve
silc_client_get_channel_by_id
silc_client_get_channel_by_id_resolve
silc_client_del_channel
silc_client_get_server
silc_client_get_server_by_id
silc_client_del_server
silc_client_on_channel
silc_client_command_call
silc_client_command_send
silc_client_command_pending
silc_client_add_private_message_key
silc_client_add_private_message_key_ske
silc_client_del_private_message_key
silc_client_list_private_message_keys
silc_client_send_private_message_key_request
silc_client_free_private_message_keys
silc_client_add_channel_private_key
silc_client_del_channel_private_keys
silc_client_del_channel_private_key
silc_client_list_channel_private_keys
silc_client_free_channel_private_keys
silc_client_current_channel_private_key
silc_client_send_key_agreement
silc_client_perform_key_agreement
silc_client_perform_key_agreement_fd
silc_client_abort_key_agreement
silc_client_set_away_message
SilcConnectionAuthRequest
silc_client_request_authentication_method
SilcClientMonitorStatus
SilcClientFileError
SilcClientFileMonitor
SilcClientFileName
SilcClientFileAskName
silc_client_file_send
silc_client_file_receive
silc_client_file_close
silc_client_attribute_add
silc_client_attribute_del
silc_client_attributes_get
silc_client_attributes_request
silc_client_send_packet

Copyright © 2001 - 2005 SILC Project SILC Project Website | SILC Toolkit Reference Manual Index