1EDG-GRIDFTP-MKDIR(1)           European DataGrid          EDG-GRIDFTP-MKDIR(1)
2
3
4

NAME

6       edg-gridftp-mkdir - Create a directory on a GridFTP server.
7

SYNOPSIS

9       edg-gridftp-mkdir [--proxy=proxy] [--timeout=timeout] [--parents] URL
10       [URL ...]
11
12       edg-gridftp-mkdir --usage
13
14       edg-gridftp-mkdir --help
15

DESCRIPTION

17       edg-gridftp-mkdir creates a directory on a GridFTP server.  This
18       command will return a status of 0 if the directory was created
19       successfully.  In all other cases, it will return a non-zero value and
20       print an error message to the standard error.
21
22       If the --parents option is given any parent directories of the given
23       URL will also be created.
24
25       If more than one URL is given, then the URLs are processed
26       sequentially.  The processing will stop with the first failure.
27
28       NOTE: The creation is only attempted if the URL does not already exist.
29       If the given file is a regular file, this command will return success.
30

OPTIONS

32       --proxy=proxy
33           Set the proxy to use for the GridFTP operation.  If this is unset,
34           then the underlying GridFTP library will try to find the proxy in
35           the usual locations.  This is useful if the proxy is in a non-
36           standard location, or the caller is a daemon which must act on the
37           behalf of a user.
38
39       --timeout=timeout
40           Set the overall time (in seconds) within which all the directory
41           creations must complete. If no timeout is specified a default 120
42           second timeout will be used.  A negative or zero timeout will
43           report a timeout error before attempting to contact any of the FTP
44           servers. If an operation times out some directories may have
45           already been created and will remain.
46
47       --parents
48           If this option is given, then any parent directories which do not
49           already exist will also be created.  Note that internally the URL
50           list is just expanded to include the parent URLs in the processing
51           list.  If an error occurs, it is possible that a partial path was
52           created.
53
54       --usage
55           Short description of the usage of this command is given.
56
57       --help
58           A description of the usage of this command and information on all
59           of the options is given.
60
61       URL URLs of the following formats are accepted:
62
63           ftp://ftp.server.org//absolute/file/name
64           gsiftp://gridftp.server.org/~/home/relative/dirname
65           gridftp://gridftp.server.org/home/relative/dirname
66
67           Note: for the URLs without a tilde, the server configuration
68           determines whether the filename is absolute or relative.  On
69           servers which do not restrict users to their home areas, the tilde
70           notation will not work.
71

AUTHOR

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

LICENSE

77       Copyright (c) 2002 by Charles A. Loomis, Jr. and Le Centre National de
78       la Recherche Scientifique (CNRS).  All rights reserved.
79
80       The software was distributed with and is covered by the European
81       DataGrid License.  A copy of this license can be found in the included
82       LICENSE file.  This license can also be obtained from
83       http://www.eu-datagrid.org/license.
84
85       The underlying GridFTP library is part of the Globus Toolkit (TM) and
86       is covered by the Globus Toolkit Public License.  See
87       http://www.globus.org for more information.
88
89
90
911.2.9.2                           2023-07-19              EDG-GRIDFTP-MKDIR(1)