Name
upload — handle a file uploaded by a client.
Synopsis
::rivet::upload  (channel | save | data | exists | size | type | filename)
Description
		    The upload command is for file upload manipulation.
		    See the relevant Apache Directives to further configure the
		    behavior of this Rivet feature.
		
- 
			    ::rivet::upload   channel  ?uploadname?
 
- 
				    When given the name of a file upload
	    			- uploadname,
				    returns a Tcl channel that can be used to access the
				    uploaded file.
 
- 
			    ::rivet::upload   save  ?uploadname? ?filename?
 
- 
				Saves the - uploadnamein
				the file- filename.
 
- 
			    ::rivet::upload   data  ?uploadname?
 
- 
				Returns data uploaded to the server.  This is binary clean
				- in other words, it will work even with files like
				images, executables, compressed files, and so on.
			     
- 
			    ::rivet::upload   exists  ?uploadname?
 
- 
				Returns true if an upload named  ?uploadname?
				exists.  This can be used in scripts that are meant to
				be run by different forms that send over uploads that
				might need specific processing.
			     
- 
			    ::rivet::upload   size  ?uploadname?
 
- 
				Returns the size of the file uploaded.
			     
- 
			    
			
- 
				If the - Content-typeis set, it is
				returned, otherwise, an empty string.
 
- 
			    ::rivet::upload   filename  ?uploadname?
 
- 
				Returns the filename on the remote host that uploaded the file.
			     
- 
			    ::rivet::upload   tempname  ?uploadname?
 
- 
				Returns the name of the temporary file on the local host that the file was uploaded into.
			     
- 
			    
			
- 
				Returns the variable names, as a list, of all the files uploaded.
			     
		    See Example 4, “File Upload”.