MOUNTWEBDAV(8)           BSD System Manager's Manual          MOUNTWEBDAV(8)

NAME
     mountwebdav -- mount a WebDAV filesystem

SYNOPSIS
     mountwebdav [-S] [-afd] [-v volumename] [-o options]
                  [scheme://]host[:port][/path] node

DESCRIPTION
     The mountwebdav command mounts the WebDAV-enabled server directory at
     [scheme://]host[:port][/path] at the mount point indicated by node.

     The user and group IDs for all files and directories are set to unknown,
     and the permissions default to read, write and execute for user, group
     and other.

     The arguments and options are:

     -S      Suppresses all user interface including the authentication
             dialogs and the non-responsive ("disconnect") server dialogs. If
             the server connection becomes non-responsive, the file system is
             immediately unmounted when this option has been used.

     -afd    A file descriptor which identifies a file containing the username
             and the password.  This option is deprecated in Mac OS X 10.4 and
             may not be supported in future releases. Use the FSMountServer-
             VolumeSync() and FSMountServerVolumeAsync() APIs in Carbon-
             Core/Files.h instead.

     -o      Options passed to mount(2) are specified with the -o option fol-
             lowed by a comma-separated string of options. See the mount(8)
             man page for possible options and their meanings. If connecting
             to a Class 1 compliant WebDAV server, the rdonly option will be
             set even if it was not specified because mountwebdav will not
             allow files to be opened with write access on servers which do
             not support the DAV LOCK method.

     -v volumename
             Allows the volumename attribute (ATRVOLNAME) returned by
             getattrlist(2) to be specified. If the volumename is not speci-
             fied, the last path component name of the node path is used as
             the volumename.

     [scheme://]host[:port][/path]
             The WebDAV-enabled server directory (collection resource) to
             mount as a volume.  The scheme, if specified, must be "http:/"
             or "https:/". If the scheme is not specified, then "http:/" is
             used.  If the port is not specified, then port 80 is used when
             the scheme is "http:/" or port 443 is used when the scheme is
             "https:/".  If the path is not specified, then the path "/" is
             used.

     node    Path to mount point.

EXAMPLES
     The following example illustrates how to mount the WebDAV-enabled server
     directory http://idisk.mac.com/membername/ at the mount point
     /Volumes/mntpnt/.

           mountwebdav http:/idisk.mac.com/membername/ /Volumes/mntpnt/

DIAGNOSTICS
     The mountwebdav utility exits 0 on success, and >0 if an error occurs.
     Here is a list of common results (other error results not listed may be
     returned):

     0                  mountwebdav successfully mounted the server direc-
                        tory.

     [ENOENT]           The server directory could not be mounted by
                        mountwebdav because the node path is invalid.

     [ENODEV]           The server directory could not be mounted by
                        mountwebdav because it is not WebDAV-enabled or
                        because it does not exist, or because node does not
                        have proper access.

     [ECANCELED]        The server directory could not be mounted by
                        mountwebdav because the user did not provide proper
                        authentication credentials.

COMPATIBILITY
     As noted above, the -afd option is considered deprecated in Mac OS X 10.4
     and may not be supported in future releases. Use the FSMountServerVol-
     umeSync() and FSMountServerVolumeAsync() APIs in CarbonCore/Files.h
     instead.

SEE ALSO
     mount(2), unmount(2), mount(8) getattrlist(2)

HISTORY
     The mountwebdav command first appeared Mac OS X Version 10.0. Support
     for HTP Digest Access authentication was added in Mac OS X Version
     10.1.1. Support for the https URL scheme, and for additional authentica-
     tion methods and proxies supported by the CFNetwork framework were added
     in Mac OS X Version 10.4.

Mac OS X                       December 3, 2004                       Mac OS X