EDG-GRIDFTP-LS(1)

📦
version 1.2.9.2 · 4 versions
, in epel 9

💅 edg-gridftp-ls — bestie's guide to peeking at grid files ✨

okay so real talk, this is edg-gridftp-ls, and it lives in the European DataGrid world (manual page EDG-GRIDFTP-LS(1), iykyk). lowkey it's just ls energy but for GridFTP URLs, and honestly? iconic.

🌸 NAME 🌸

edg-gridftp-ls — list a file or the contents of a directory. that's it, that's the vibe 🫶

✨ SYNOPSIS ✨

edg-gridftp-ls [--proxy=proxy] [--timeout=timeout] [--verbose]
[--noauth] URL

edg-gridftp-ls --usage

edg-gridftp-ls --help

🦋 DESCRIPTION 🦋

so edg-gridftp-ls lists stuff — to the standard output, no cap — either a single file or the whole contents of a directory, for whatever URL you hand it. it's giving "directory reveal" main character energy.

if it works? zero status. slay. 💖

in literally all other cases it returns a non-zero value and prints an error message to the standard error. so like, not subtle. it will tell you. 😭

🎀 OPTIONS 🎀

  • --proxy=proxy — sets the proxy to use for the GridFTP operation. if you leave this unset, the underlying GridFTP library goes hunting for the proxy in the usual locations by itself (iconic scavenger behavior). this option is your bestie when the proxy lives somewhere non-standard, or when the caller is a daemon that has to act on behalf of a user. 🧚
  • --timeout=timeout — sets the time, in seconds, within which the listing must complete. no timeout specified? a default 120 second timeout gets used, periodt. and listen: a negative or zero timeout will report a timeout error before even attempting to contact the FTP server. so it fails fast, fr fr. 💀
  • --verbose — if this flag is set, the listing includes more information about the status of the file, in addition to the filename. so you get the tea and the metadata. 👑
  • --noauth — if this flag is set, authentication of the data channel gets turned off. it's on by default, so this is you actively choosing chaos 🙈.
  • --usage — gives a short description of the usage of this command.
  • --help — gives a description of the usage of this command and info on all of the options. the full lore drop. 📖
  • URL — URLs of the following formats are accepted, bestie:
ftp://ftp.server.org//absolute/file/name
gsiftp://gridftp.server.org/~/home/relative/name.txt
gridftp://gridftp.server.org/home/relative/name.txt
⚠️ note (and this one matters): 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 like… check your server, don't come for me 😭

💜 AUTHOR 💜

Charles Loomis (charles.loomis@cern.ch). later modifications by CERN IT-DM/SMD. legends, honestly. 🫡

🌈 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 — version 1.2.9.2, dated 2022-01-20, brought to you by the European DataGrid girlies. go list something iconic 💅🎀

📦 where this page comes from