= Deleting files =

To delete a file from a host, use the function

{{{
delete_file(int host_id, const char* file_name)
}}}

or the command line program (run from the project root dir)

{{{
delete_file -host_id X -file_name Y
}}}

`delete_file()` creates a message for the specific host and adds it to the `msg_to_host` table. This message instructs the client to delete the file. The message is included in the next scheduler reply to the host. The message XML has the form

{{{
<delete_file_info>file_name</delete_file_info>
}}}

For this to work, you need to include {{{<msg_to_host/>}}} in [ProjectOptions#client-control config.xml].