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

Function silc_channel_name_check
SYNOPSIS

        unsigned char *
        silc_channel_name_check(const unsigned char *identifier,
                                SilcUInt32 identifier_len,
                                SilcStringEncoding identifier_encoding,
                                SilcUInt32 max_allowed_length,
                                SilcUInt32 *out_len);

DESCRIPTION

        Checks that the 'identifier' string is valid channel name string
        and does not contain any unassigned or prohibited character.

        If the 'max_allowed_length' is non-zero the identifier cannot be
        longer than that, and NULL is returned if it is.  If zero (0), no
        length limit exist.  For channel names the max length must be 256
        bytes.

        Returns the validated string, that the caller must free.  Returns
        NULL if the identifier string is not valid or contain unassigned or
        prohibited characters.  Such identifier strings must not be used
        SILC protocol.  The returned string is always in UTF-8 encoding.
        The length of the returned string is in 'out_len'.

NOTES

        In addition of validating the channel name string, this function
        may map characters to other characters or remove characters from the
        original string.  This is done as defined in the SILC protocol.  Error
        is returned only if the string contains unassigned or prohibited
        characters.  The original 'identifier' is not modified at any point.

SILC String Utilities SilcStringEncoding silc_pem_encode silc_pem_encode_file silc_pem_decode silc_mime_parse silc_strncat silc_identifier_check silc_identifier_verify silc_channel_name_check silc_channel_name_verify

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