sitecopy supports the HTTP-DAV (WebDAV) or FTP protocols - the .B protocolkey specifies which to use, taking the value of either.B httpor .B ftprespectively. By default, FTP will be used.The .B proxy-serverand.B proxy-portkeys may be used to specify a proxy server to use. Proxy serversare currently only supported for WebDAV mode.If the FTP server does not support passive (PASV) mode, thenthe key.B ftp nopasvshould be used.If the WebDAV server does not correctly support the 100-continueexpectation, e.g. Apache 1.3.6 and before, the key.B http noexpectshould be used.To authenticate the user with the server, the .B usernameand .B password keys are used. If it exists, the.B ~/.netrcwill be searched for a password if one is not specified. Seeftp(1) for the syntax of this file.Basic and digest authentication are supported forWebDAV. Note that basic authentication must not be used unless theconnection is known to be secure.The full URL that is used to access the site can optionally bespecified in the.B urlkey. This is used only in flat list mode, so the site URLcan be inserted in 'Recent Changes' pages. The URL must.I nothave a trailing slash; a valid example is.br.BR "	url " http://www.site.com/mysite.SS File Storage LocationsThe .B remotekey specifies the root directory of the remote copy of the site.It may be in the form of an absolute pathname, e.g..br.BR "	remote " /www/mysite/.brFor FTP, the directory may also be specified relative to the logindirectory, in which case it must be prefixed by "~/", for example:.br.BR "	remote " ~/public_html/.PPThe.B localkey specifies the directory in which the site is stored locally.  Thismay be given relative to your home directory (as given by theenvironment variable $HOME), again using the "~/" prefix..br.BR "	local " "~/html/foosite/".br.BR "	local " "/home/fred/html/foosite/".brare equivalent, if $HOME is set to "/home/fred".For both the local and remote keywords, a trailing slash may be used,but is not required..SS File Permissions HandlingFile permissions handling is dictated by the .B permissionskey, which may be given one of three values:.TP .B ignoreto ignore file permissions completely,.TP.B execto mirror the permissions of executable files only,.TP.B allto mirror the permissions of all files..PPThis can be used, for instance, to ensure the permissions of CGI filesare set. The option is currently ignored for WebDAV servers. For FTPservers, a.B chmodis performed remotely to set the permissions..SS Symbolic Link HandlingSymlinks found in the local site can be either ignored, followed, ormaintained. In 'follow' mode, the files references by the symlinkswill be uploaded in their place. In 'maintain' mode, the link will becreated remotely as well, see below for more information. The modeused for each site is specified with the.B symlinksrcfile key, which may take the value of.B ignore,.B followor.B maintainto select the mode as appropriate.The default mode is.B ignore,i.e. symbolic links found in the local site are ignored..SS Symbolic link Maintain ModeThis mode is currently only supported by the WebDAV driver, and willwork only with servers which implement WebDAV Advanced Collections,which is a work-in-progress. The target of the link on the server isliterally copied from the target of the symlink. Hint: you can useURL's if you like:.br.B "	ln -s" """http://www.somewhere.org/""" somewherehomeIn this way, standard 302-redirect's can be easily set up from theclient, without having to alter the server configuration..SS Deleting and Moving Remote FilesThe .B nodeleteoption may be used to prevent remote files from ever beingdeleted. This may be useful if you keep large amounts of data on theremote server which you do not need to store locally as well.If your server does not allow you to upload changed files overexisting files, then you can use the.B nooverwriteoption. When this is used, before uploading a changed file, theremote file will be deleted.If the .B checkmovedoption is used, sitecopy will look for any files which have beenmoved locally. If any are found, when the remote site is updated,the files will be moved remotely.sitecopy will only detect moved files if a moved file has the samename, modification time, and size as the original file..B WARNING:Do NOT use the .B checkmovedoption if you tend to hold files in different directories withidentical sizes, modification times and names and ever move themabout. This seems unlikely, but don't say you haven't been warned..SS Excluding FilesLocal files may be ignored by sitecopy by use of the.B excludekey, which accepts shell-style globbing patterns. For example, use.br.BR "	exclude " "*.bak".br.BR "	exclude " *~.br.BR "	exclude " """#*#""".brto exclude all files which have a .bak extension, end in a tilde (~)character, or which begin and end with a a hash. Don't forget to quoteor escape the value if it includes a hash!To exclude certain files within an particular directory, simply prefixthe pattern with the directory name - including the leading slash. Forinstance:.br.BR "	exclude " "/docs/*.m4".br.BR "	exclude " "/files/*.gz".brwhich will exclude all files with the .m4 extension in the 'docs'subdirectory of the site, and all files with the .gz extension in thefiles subdirectory.An entire directory can also be excluded - simply use the directoryname with no trailing slash. For example.br.BR "	exclude " "/foo/bar".br.BR "	exclude " "/where/else".brto exclude the 'foo/bar' and 'where/else' subdirectories of the site..SS FTP Transfer ModeTo specify the FTP transfer mode for files, use the.B asciikey. Any files which are transferred using ASCII mode haveCRLF/LF translation performed appropriately. For example, use.br.BR "	ascii " "*.pl".brto upload all files with the .pl extension as ASCII text.This key has no effect with WebDAV (currently)..SH EXAMPLE RCFILE CONTENTS.SS FTP Server, Simple UsageFred's site is uploaded to the FTP server 'my.server.com'and held in the directory 'public_html', which is in thelogin directory. The site is stored locally in the directory /home/fred/html.site mysite  server my.server.com  url http://www.server.com/fred  username fred  password juniper  local /home/fred/html/  remote ~/public_html/.SS FTP Server, Complex UsageHere, Freda's site is uploaded to the FTP server\'ftp\.elsewhere\.com\', where it is held in the directory/www/freda/. The local site is stored in /home/freda/sites/elsewhere/site anothersite  server ftp\.elsewhere\.com  username freda  password blahblahblah  local /home/freda/sites/elsewhere/  remote /www/freda/  # Freda wants files with a .bak extension or a   # trailing ~ to be ignored:  exclude *.bak  exclude *~.SS WebDAV Server, Simple UsageThis example shows use of a WebDAV server.site supersite  server dav.wow.com  protocol http  username pow  password zap   local /home/joe/www/super/  remote /.SH FILES.I ~/.sitecopyrc Default run control file location..br.I ~/.sitecopy/Remote site information storage directory.br.I ~/.netrcRemote server accounts information.br.SH BUGSSmall creepy crawly things - avoid at all costs..PPKnown problems: Fetch + synch modes for FTP have been tested abouttwice - they WILL delete all your files..SH SEE ALSOrsync(1), ftp(1), mirror(1).SH STANDARDS.BR "RFC 959" " - File Transfer Protocol (FTP)".br.BR "RFC 1521" " - Multipurpose Internet Mail Extensions Part One".br.BR "RFC 1945" " - Hypertext Transfer Protocol -- HTTP/1.0".br.BR "RFC 2396" " - Uniform Resource Identifiers: Generic Syntax".br.BR "RFC 2518" " - HTTP Extensions for Distributed Authoring -- WEBDAV".br.BR "RFC 2616" " - Hypertext Transfer Protocol -- HTTP/1.1".br.BR "RFC 2617" " - HTTP Authentication".br.BR "REC-XML" " - Extensible Markup Language (XML) 1.0".br.BR "REC-XML-NAMES" " - Namespaces in XML".SH DRAFT STANDARDS.BR "draft-ietf-ftpext-mlst-05.txt" " - Extensions to FTP".br.BR "draft-ietf-webdav-collections-protocol-03.txt" " - WebDAV Advanced Collections Protocol".SH AUTHORJoe Orton <joe@orton.demon.co.uk>and others.