Vely logo install examples
documentation about

14.2.0 released on Nov 29, 2022

send-file



PURPOSE:


Send file to client.

SYNTAX:



send-file <file> [ headers \
    [ content-type <content type> ] \
    [ download ] \
    [ etag ] \
    [ file-name <file name> ] \
    [ ( cache-control <cache control> ) | no-cache ] \
    [ status-id <status id> ] \
    [ status-text <status text> ] \
    [ custom <header name>=<header value> [ , ... ] ]
    ]


DESCRIPTION:


When a client requests download of a file, you can use send-file to provide <file>, which is its location on the server, and is either a full path or relative to the application home directory (see vv). Note however that you can never use dot-dot (i.e. "..") in <file> - this is a security measure to avoid path-traversal attacks. Thus the file name should never have ".." in it, and if it does, the program will error out and stop.

Headers


The following are subclauses that allow setting any custom header:

Cookies


Any cookies set prior to send-file (see set-cookie and delete-cookie) will be sent along with the file to the web client.

EXAMPLES:


To send a document back to the browser and show it, use send-file with the "show" clause:

send-file "/home/vely/files/myfile.jpg" headers content-type "image/jpg"

An example to display a PDF document:

char *pdf_doc="/home/mydir/myfile.pdf";
send-file pdf_doc headers content-type "application/pdf"

If you want to send a file to the client for download (with the dialog), use "download" clause. This way the document is not displayed but the "Save As" (or similar) window shows up, for example to download a "PDF" document:

send-file "/home/user/file.pdf" headers download content-type "application/pdf"


SEE ALSO:


Web ( call-web   out-header   send-file   silent-header  )  SEE ALL (documentation)



Copyright (c) 2022 DaSoftver LLC. Vely is a trademark of Dasoftver LLC. The software and information herein are provided "AS IS" and without any warranties or guarantees of any kind. Some icons copyright PaweĊ‚ Kuna licensed under MIT. Vely elephant logo copyright DaSoftver LLC. This web page is licensed under CC-BY-SA-4.0.