ARCLS(1)

📦
version 7.2.0 · 13 versions
, in fedora 43, fedora 44

💖 ARCLS(1) 💖

okay bestie, listen — this is the manual page for arcls, a User Command, and it's literally the "show me what's in here" queen of the ARC universe. no cap. ✨

🌸 NAME 🌸

arcls — list files or directories. that's it. that's the whole job. and she EATS every time. 💅

✨ DESCRIPTION ✨

🎀 Usage 🎀

arcls [OPTION...] url

so the vibe is: you give her a url, you sprinkle some OPTION... on top, and she tells you what's inside. 🦋

The arcls command is used for listing files in grid storage elements and file index catalogues. like, she walks into the grid storage element and goes "hi bestie what do we have here" and then actually tells you. iconic behaviour honestly. 👑

🔥 OPTIONS 🔥

okay this is the part where we go through EVERY single flag, no skipping, no "yeah you get the idea". we're thorough in this house. 🫶

  • -h, --help — Show help options. she'll explain herself. self-aware queen. 💖
  • -l, --long — long format (more information). more info, more drama, more everything. 🌈
  • -L, --locations — show URLs of file locations. where the file actually lives. doxxing, but make it polite. 📍
  • -m, --metadata — display all available metadata. spill the tea, all of it, every last drop. 🍓
  • -r, --recursive — operate recursively. she goes DEEP. all the way down. no folder left behind. 🕳️
  • -D, --depth=level — operate recursively up to specified level. same energy as -r but she stops at level like a responsible adult. boundaries! we love them. ✋
  • -n, --nolist — show only description of requested object, do not list content of directories. just the description, bestie. she's giving mysterious. 🙈
  • -f, --forcelist — treat requested object as directory and always try to list content. she's gonna try anyway. manifesting. ✨
  • -c, --checkaccess — check readability of object, does not show any information about object. just "can I read this or not" and literally nothing else. a yes/no girlie. 🎀
  • -P, --listplugins — list the available plugins (protocols supported). the whole roster. the lineup. the squad. 👯
  • -t, --timeout=seconds — timeout in seconds (default 20). twenty seconds is the default, and then she's OUT. ⏰
  • -z, --conffile=filename — configuration file (default ~/.arc/client.conf). that's the default path, fr fr. 📁
  • --no-authentication — do not perform any authentication for opened connections. just rawdogging the connection, no credentials. 🚪
  • --x509-authentication — perform X.509 authentication for opened connections. fancy certificate energy. 📜
  • --token-authentication — perform token authentication for opened connections. token! like a little key but cooler. 🔑
  • --systemca — force using CA certificates configuration provided by OpenSSL. 🐧
  • --gridca — force using CA certificates configuration for Grid services (typically IGTF). 🌐
  • --anyca — force using both CA certificates configuration for Grid services (typically IGTF) and those provided by OpenSSL. both. at once. greedy (affectionate). 💅
  • --allowinsecureconnection — allow TLS connection which failed verification. > ⚠️ bestie this one is literally in the name: it lets through a TLS connection that failed verification. she said yes to a red flag. proceed with your whole chest and your whole understanding of the consequences. 💀
  • -d, --debug=debuglevel — FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG. pick your chaos level, from "everything is on fire" to "tell me literally everything". 🔍
  • -v, --version — print version information. who is she? she'll tell you. 👑

🦋 EXTENDED DESCRIPTION 🦋

The arcls command lists files and directories on grid storage elements and in file index catalogues. Depending on the installed libraries (check with -P), the following protocols may be used: file (file:// prefix may be omitted), http, https, httpg, ftp, gsiftp, srm, root.

so like — check with -P first, because which protocols you actually get depends on what libraries are installed on your machine. she's adaptable. 💅

In the case of a directory/fileset, attributes of objects belonging to it will be retrieved, unless --nolist is specified. so by default she's nosy and grabs all the attributes, and if you hit her with --nolist she chills out. 🙈

If url starts from '@', the remainder should be a path to a local file containing list of URLs, one per line. Then arcls acts as if it was called multiple times, once for each URL. so you can hand her a whole list and she'll just do the rounds, one URL at a time, no complaints. 🫶

For more information on ARC URL syntax please read "Protocols, Uniform Resource Locators (URL) and Extensions Supported in ARC" [NORDUGRID-TECH-7] — yes that's the actual document name, go read it, it's giving lore. 📚

🌈 ENVIRONMENT VARIABLES 🌈

  • X509_USER_PROXY — The location of the user's Grid proxy file. Shouldn't be set unless the proxy is in a non-standard location. so like, leave it alone unless your proxy is living somewhere weird. don't set it for fun. 🙅
  • ARC_LOCATION — The location where ARC is installed can be specified by this variable. If not specified the install location will be determined from the path to the command being executed, and if this fails a WARNING will be given stating the location which will be used. so: set it, or she guesses, and if she has to guess she'll at least tell you what she guessed. 💖
  • ARC_PLUGIN_PATH — The location of ARC plugins can be specified by this variable. Multiple locations can be specified by separating them by : (; in Windows). The default location is $ARC_LOCATION/lib/arc (\ in Windows). multiple paths, colon-separated on unix, semicolon on windows, and that default path is exactly $ARC_LOCATION/lib/arc. 🧚

🍓 EXAMPLE 🍓

arcls -l gsiftp://example.com/grid/file.dat

look at her go. long format, gsiftp, one file. chef's kiss. 😘

💜 FILES 💜

  • ~/.arc/client.conf — Some options can be given default values by specifying them in the ARC client configuration file. By using the --conffile option a different configuration file can be used than the default. so you can set defaults in there, or point her at a totally different file with --conffile. your call, bestie. 🎀

👑 AUTHOR 👑

ARC software is developed by the NorduGrid Collaboration (http://www.nordugrid.org), please consult the AUTHORS file distributed with ARC. Please report bugs and feature requests to http://bugzilla.nordugrid.org

like, credit where credit is due, and if something's broken — bugzilla. they want to hear it, fr fr. 🫶

APACHE LICENSE Version 2.0

🌟 SEE ALSO 🌟

arccp(1), arcmkdir(1), arcrename(1), arcrm(1)

the whole friend group. go say hi. 💖

and that's the whole page, bestie!! this was arcls version 7.2.0, from September 2026 — she's thriving, she's listing, she's iconic. mwah. 💅✨🎀🦋🌸

📦 where this page comes from