edg-gridftp-mkdir man page

edg-gridftp-mkdir — Create a directory on a GridFTP server.

Synopsis

edg-gridftp-mkdir [--proxy=proxy] [--timeout=timeout] [--parents] URL [URL ...]

edg-gridftp-mkdir --usage

edg-gridftp-mkdir --help

Description

edg-gridftp-mkdir creates a directory on a GridFTP server. This command will return a status of 0 if the directory was created successfully. In all other cases, it will return a non-zero value and print an error message to the standard error.

If the --parents option is given any parent directories of the given URL will also be created.

If more than one URL is given, then the URLs are processed sequentially. The processing will stop with the first failure.

NOTE: The creation is only attempted if the URL does not already exist. If the given file is a regular file, this command will return success.

Options

--proxy=proxy
Set the proxy to use for the GridFTP operation. If this is unset, then the underlying GridFTP library will try to find the proxy in the usual locations. This is useful if the proxy is in a non-standard location, or the caller is a daemon which must act on the behalf of a user.
--timeout=timeout
Set the overall time (in seconds) within which all the directory creations must complete. If no timeout is specified a default 120 second timeout will be used. A negative or zero timeout will report a timeout error before attempting to contact any of the FTP servers. If an operation times out some directories may have already been created and will remain.
--parents
If this option is given, then any parent directories which do not already exist will also be created. Note that internally the URL list is just expanded to include the parent URLs in the processing list. If an error occurs, it is possible that a partial path was created.
--usage
Short description of the usage of this command is given.
--help
A description of the usage of this command and information on all of the options is given.
URL
URLs of the following formats are accepted:

ftp://ftp.server.org//absolute/file/name gsiftp://gridftp.server.org/~/home/relative/dirname gridftp://gridftp.server.org/home/relative/dirname

Note: for the URLs without a tilde, the server configuration determines whether the filename is absolute or relative. On servers which do not restrict users to their home areas, the tilde notation will not work.

Author

Charles Loomis (charles.loomis@cern.ch). Later modifications by CERN IT-DM/SMD.

License

Copyright (c) 2002 by Charles A. Loomis, Jr. and Le Centre National de la Recherche Scientifique (CNRS). All rights reserved.

The software was distributed with and is covered by the European DataGrid License. A copy of this license can be found in the included License file. This license can also be obtained from http://www.eu-datagrid.org/license.

The underlying GridFTP library is part of the Globus Toolkit (TM) and is covered by the Globus Toolkit Public License. See http://www.globus.org for more information.

Info

2008-02-25 1.2.9.2 European DataGrid