int xfer_addwild

(char mode, char* filespec, char* description,
int32 refund, int32 credspermin)

Add a number of files to the transfer queue.

Documentation

Add a number of files to the transfer queue.

This function adds zero or more files for transfer, based on a UNIX glob (filename with wildcards). This function is very similar to xfer_add(), but is more useful for downloads than uploads. Be warned, this function executes the find UNIX command to expand the glob. This implies a relative lack of speed and a serious lack of security.

DO NOT CALL THIS FUNCTION WITH USER-SUPPLIED VALUES FOR THE filespec ARGUMENT.

Parameters:

mode - one of the FXM_x file transfer modes.
filespec - a glob that will be expanded in order to get the filenames. Anything that you could give to, say, ls is acceptable. Incorrectly formed globs will simply yield no filenames.
- description a short (50 bytes including terminating null) description of the files. The description will be common to all files.
- refund how many credits we will refund the user for canceling EACH FILE in this transfer.
- credspermin credit consumption rate during the file transfer. This quantity is times 100. To specify consumption of 2.5 credits per minute, use 250. Specify 0 for no time-based credit charges, or -1 for the current per-minute charge, whatever that is.

Returns:

This function returns 0 if the find command could not run to expand the glob, or if the file transfer queue for this user could not be appended to.

See Also:

xfer_setaudit(), xfer_setcmd(), xfer_add()

Alphabetic index