EDG-GRIDFTP-EXISTS(1)

📦
version 1.2.9.2 · 4 versions
, in epel 9

💅 edg-gridftp-exists — the manual, bestie edition ✨

okay so you found the EDG-GRIDFTP-EXISTS(1) page from the European DataGrid and you're like "what does this even do" — don't worry, I gotchu 🫶. Sit down, hydrate, and let's vibe-check your GridFTP files together.

✨ NAME ✨

edg-gridftp-exists — literally just tells you if a file or directory exists on a GridFTP server. That's it. That's the whole job. Iconic minimalism honestly 👑

🌸 SYNOPSIS 🌸

edg-gridftp-exists [--proxy=proxy] [--timeout=timeout] [--noauth] URL
[URL ...]

edg-gridftp-exists --usage

edg-gridftp-exists --help

so you run it, you hand it a URL (or several, she's generous like that), and she tells you what's up 💫

🦋 DESCRIPTION 🦋

edg-gridftp-exists determines whether the file or directory associated with the URL(s) you gave actually exists.

The rules, no cap:

  • It returns a status of 0 if the file or directory exists. Slay 💖
  • In all other cases it returns a non-zero value and prints an error message to the standard error. Sad girl hours 😭

And here's the multi-URL tea ☕: if more than one URL is given, a successful return only happens if all of the URLs exist. Processing stops with the first failure — she does not keep going after a flop, she's got boundaries.

🎀 OPTIONS 🎀

  • --proxy=proxy — sets the proxy to use for the GridFTP operation. If you leave it unset, the underlying GridFTP library will try to find the proxy in the usual locations. This one's super useful when your proxy lives somewhere non-standard, or when the caller is a daemon that has to act on behalf of a user (daemon bestie needs a proxy hookup 🙈).
  • --timeout=timeout — sets the overall time (in seconds) within which all the checks must complete. If you don't specify a timeout, a default 120 second timeout is used. And heads up: a negative or zero timeout will report a timeout error before attempting to contact any of the FTP servers. Like, she doesn't even try. Respect the boundary 💅
  • --noauth — if this flag is set, authentication of the data channel is turned off. It is on by default. So only flip it if you know what you're doing, bestie ⭐
  • --usage — gives you a short description of the usage of this command.
  • --help — gives you a description of the usage of this command plus info on all of the options. The full lore drop 📖

🌈 URL — the URLs

URL — these are the URL formats she accepts, and yes, the number of slashes matters, don't @ me:

ftp://ftp.server.org//absolute/file/name
gsiftp://gridftp.server.org/~/home/relative/name.txt
gridftp://gridftp.server.org/home/relative/name.txt
⚠️ Note (important, don't skip): for the URLs without a tilde, the server configuration determines whether the filename is absolute or relative. And on servers which do not restrict users to their home areas, the tilde notation will not work. So the ~ is not universal, she's home-area-specific, iykyk.

🔥 AUTHOR 🔥

Charles Loomis (charles.loomis@cern.ch). Later modifications by CERN IT-DM/SMD. Shoutout to the maintainers, genuine icons 👑

💜 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. Legal bestie has entered the chat 🧚

okay that's the whole page, you're officially educated 💖

version 1.2.9.2, dated 2022-01-20 — that's the tea from the European DataGrid, and this manual page is officially a wrap 💅✨🎀

📦 where this page comes from