diff --git a/reference/ftp/functions/ftp-alloc.xml b/reference/ftp/functions/ftp-alloc.xml new file mode 100644 index 0000000000..ee9263830c --- /dev/null +++ b/reference/ftp/functions/ftp-alloc.xml @@ -0,0 +1,87 @@ + + + + + ftp_alloc + Allocates space for a file to be uploaded. + + + Description + + boolftp_alloc + resourceftp_stream + intfilesize + string&result + + + Sends an ALLO command to the remote FTP server to allocate filesize + bytes of space. Returns &true; on success, or &false; on failure. + + + + Many FTP servers do not support this command. These servers may return a failure + code (&false;) indicating the command is not supported or a success code (&true;) + to indicate that pre-allocation is not necessary and the client should continue + as though the operation were successful. Because of this, it may be best to reserve + this function for servers which explicitly require preallocation. + + + + A textual representation of the servers response will be returned by reference in + result is a variable is provided. + + + + <function>ftp_alloc</function> example + + +]]> + + + + + See also: + ftp_put, and + ftp_fput. + + + + +