EDG-GRIDFTP-MKDIR(1)

📦
version 1.2.9.2 · 4 versions
, in epel 9

💅 edg-gridftp-mkdir — like, the manual, but make it make sense

okay so bestie, this is page one of the European DataGrid manual situation, and the star of the show is edg-gridftp-mkdir. Yes it's a mouthful, no we don't shorten it, it's iconic that way. Let's get into it 🎀

✨ NAME ✨

edg-gridftp-mkdir — it makes a directory on a GridFTP server. That's it. That's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

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

edg-gridftp-mkdir --usage

edg-gridftp-mkdir --help

💖 DESCRIPTION 💖

So edg-gridftp-mkdir creates a directory on a GridFTP server. That's literally its whole job and it does it.

If the directory gets created successfully, it returns a status of 0 — slay, success, we love to see it. In all other cases it returns a non-zero value and prints an error message to the standard error. Not subtle, but honestly? Fair. 😭

If you pass the --parents option, any parent directories of the URL you gave will also get created. Like, the whole family tree gets made. 🧚

If more than one URL is given, the URLs are processed sequentially — one after the other, no jumping the queue — and the processing stops with the first failure. First one to flop ends the whole run, periodt.

⚠️ NOTE: the creation is only attempted if the URL does not already exist. And lowkey important: if the given file is a regular file, this command will return success. So it's not gonna yell at you, it just goes "already there, we're good" 💀

✨ OPTIONS ✨

  • --proxy=proxy — sets the proxy to use for the GridFTP operation. If this is unset, 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 if the caller is a daemon which must act on the behalf of a user. (daemon rights, main character energy 👑)
  • --timeout=timeout — sets 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. And heads up: 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. (so like, a half-built house 🏠)
  • --usage — a short description of the usage of this command is given. quick lil recap, iykyk.
  • --help — a description of the usage of this command and information on all of the options is given. the full tour 💅

📂 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. So check your server, bestie.

🌈 AUTHOR 🌈

Charles Loomis (charles.loomis@cern.ch). Later modifications by CERN IT-DM/SMD. shoutout to the legends fr fr 💜

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

🎀 and that's the whole page, bestie! this one's version 1.2.9.2, dated 2022-01-20, brought to you by the European DataGrid girlies. go forth and make directories, you're gonna eat 💅✨🦋

📦 where this page comes from