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”.