@CHIP-RTOS C Library - Common Gateway Interface API

SSI_Set_File_Filter

Set Server Side Include (SSI) file filter

int SSI_Set_File_Filter( char far * matchStr,
                         int matchType,
                         int server);

Parameters

matchStr

Pointer to null-terminated string depending on the machted type

matchType

Match type, possible values are:

SSI_MATCH_FILE_NAME(0x01) = File name, Example: "table.htm"
SSI_MATCH_FILE_EXT (0x02) = File extension, Example: "htm"
SSI_MATCH_FILE_PATH(0x03) = Full path to file, Example: "/web/ssi/table.htm"
SSI_MATCH_DIR_NAME (0x04) = Directory name, Example: "ssi"
SSI_MATCH_DIR_PATH (0x05) = Directory path, Example: "/web/ssi"

server

0 = register for HTTP server
1 = register for HTTPS (SSL) server

Return Value

0: success
non-zero: Failure, return value contains error code CGI_INVALID_METHOD

Comments

SSI commands are special HTML comment tags in web pages, and parsed by the web server while the pages are being served. They allow dynamically generated content to be inserted into a static page, without having to dynamically generate the whole page.
There's no official standard for SSI command. Thus we provide an API to register a SSI tag string and a handler function. When a registered SSI tag is found in a page being served, the handler function will be called to process it.

See Also

SSI_Register_Tag        SSI_Set_TagLength        

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
n/a	n/a	n/a	V0.91	V1.00

Supported by @CHIP-RTOS C Library since version

CLIB
V2.02