---
name: "xrd"
section: "1"
platform: "linux"
package: "root-system-xrootd"
version: "5.18.00-2.3~lenny1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/xrd"
---

# xrd(1)

interactive XRootD ftp-like client

## NAME

xrd - interactive XRootD ftp-like client

## SYNOPSIS

**xrd** *HOST* \[*OPTIONS*\]

## DESCRIPTION

**Xrd** is a  **ftp***-like(1)* tool to interact with an **xrootd** server.

Commands are

- **cd** *directory*

  Change directory.

- **envputint** *variable integer*

  Set an environment variable *variable* to an integer value **integer**.

- **envputstr** *variable string*

  Set an environment variable *variable* to a string value **string**.

- **help**

  Show interactive help.

- **exit**

  Exit the client

- **connect** *\[host:\[port\]\]*

  Connect to the specified host.

- **dirlist** *\[directory\]*

  Lists the contents of the specified directory or current directory if no argument is given.

- **stat** *file-or-directory*

  Get information on a file or directory.

- **existsfile** *file*

  Checks if a file exists on the server.

- **existsdir** *directory*

  Checks if a directory exists on the server.

- **getchecksum** *file*

  Computes and returns the check sum of a file.

- **isfileonline** *file*

  Tells if the specified file is online.

- **mv** *file1 file2*

  Moves *file1* to *file2* **on the same server.**

- **mkdir** *directory \[user\] \[group\] \[other\]*

  **Creates a directory with optional permissions.**

- **chmod** *file-or-directory user group other*

  **Modifies file permissions.**

- **rm** *file*

  **Removes a file.**

- **rmdir** *directory*

  **Removes a directory.**

- **prepare** *file*

  **Stages a file in.**

- **cat** *file \[xrdcp parameters\]*

  **Outputs a file on standard output using**  [**xrdcp**(1)](/xrdcp/1.md). *file* can be a **root://**

- **cp** *file-or-directory file-or-directory \[xrdcp parameters\]*

  Copies a file using [**xrdcp**(1)](/xrdcp/1.md). *file-or-directory* are always relative to the current remote path. Also, they can be **root://** URLs specifying any other host

## OPTIONS

- **-d***LEVEL*

  Set the debug level

- **-DI***param value*

  Set parameter *param* to an integer *value*. Override the default value of an internal **XrdClient** setting.

- **-DS***param value*

  Set parameter *param* to a string *value*.  Override the default value of an internal **XrdClient** setting.

- **-O**

  Adds some opaque information to any used **xrootd** url.

- **-h**

  Show help.

## SEE ALSO

[*root*(1)](/root/1.md), [*xrootd*(1)](/xrootd/1.md)

See also the **ROOT** webpages: *http://root.cern.ch* ⟨http://root.cern.ch⟩

## ORIGINAL AUTHORS

Fabrizio Furano

## COPYRIGHT

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

## AUTHOR

This manual page was written by Christian Holm Christensen \<cholm@nbi.dk\>, for the Debian GNU/Linux system (but may be used by others).