Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xrdfs(1)		    General Commands Manual		      xrdfs(1)

NAME
       xrdfs - xrootd file and directory meta-data utility

SYNOPSIS
       xrdfs [--no-cwd]	host[:port] [command [args]]

       command:	help, chmod, ls, locate, mkdir,	mv, stat, statvfs, query, rm, rmdir,
		  truncate, prepare, cat, tail,	spaceinfo

DESCRIPTION
       The xrdfs utility executes meta-data oriented operations	(e.g., ls, mv,
       rm, etc.) on one	or more	xrootd servers.	 Command help is available by
       invoking	xrdfs with no command line options or parameters and then typ-
       ing "help" in response to the input prompt.

OPTIONS
       --no-cwd
	  No CWD is being preset in interactive	mode.

COMMANDS
       chmod path _user__group__other_
	  Modify permissions of	the path. Permission string example: rwxr-x--x

       ls [-l] [-u] [-R] [-D] [-Z] [dirname]
	  Get directory	listing.
	  -l stat every	entry and pring	long listing
	  -u print paths as URLs
	  -R list subdirectories recursively
	  -D show duplicate entries
	  -Z check if file is a	ZIP archive and	if yes list its	content

       locate [-n] [-r]	[-d] [-m] [-i] [-p] _path_
	  Get the locations of the path.
	  -r refresh, don't use	cached locations
	  -n make the server return the	response immediately even though it
	  may be incomplete
	  -d do	a recursive, deep locate in order to find data servers
	  -m prefer host names to IP addresses
	  -i ignore network dependencies (IPv6/IPv4)
	  -p be	passive: ignore	tried/triedrc cgi opaque info

       mkdir [-p] [-m_user__group__other_] _dirname_
	  Creates a directory/tree of directories.
	  -p create the	entire directory tree recursively
	  -m<user><group><other> permissions for newly created directories

       mv _path1_ _path2_
	  Move path1 to	path2 locally on the same server.

       stat _path_
	  Get info about the file or directory.
	  -q <flags> Makes xrdfs return	error code 55 to the shell if the re-
	  quested flag combination is not present; flags may be	combined to-
	  gether using '|' or '&'
	  Available flags: XBitSet, IsDir, Other, Offline, POSCPending,	Is-
	  Readable, IsWriteable, BackUpExists

       statvfs _path_
	  Get info about a virtual file	system.

       query _code_ _params_
	  Obtain server	information. Query codes:
	  config	 <what>	  Server configuration;	<what> is one of the
	  following:
	       bind_max	     - the maximum number of parallel streams
	       chksum	     - the supported checksum
	       pio_max	     - maximum number of parallel I/O requests
	       readv_ior_max - maximum size of a readv element
	       readv_iov_max - maximum number of readv entries
	       tpc	     - support for third party copies
	       wan_port	     - the port	to use for wan copies
	       wan_window    - the wan_port window size
	       window	     - the tcp window size
	       cms	     - the status of the cmsd
	       role	     - the role	in a cluster
	       sitename	     - the site	name
	       version	     - the version of the server
	  checksumcancel <path>	  File checksum	cancelation
	  checksum	 <path>	  File checksum
	  opaque	 <arg>	  Implementation dependent
	  opaquefile	 <arg>	  Implementation dependent
	  space		 <space>  Logical space	stats
	  stats		 <what>	  Server stats;	<what> is a list of letters
	  indicating information to be returned:
	       a - all statistics
	       p - protocol statistics
	       b - buffer usage	statistics
	       s - scheduling statistics
	       d - device polling statistics
	       u - usage statistics
	       i - server identification
	       z - synchronized	statistics
	       l - connection statistics
	  xattr		 <path>	  Extended attributes
	  prepare	 <reqid> [filenames]  Prepare request status

       rm _filename_
	  Remove a file.

       rmdir _dirname_
	  Remove a directory.

       truncate	_filename_ _length_
	  Truncate a file.

       prepare [-c] [-f] [-s] [-w] [-e]	[-p priority] [-a requestid] filenames
	  Prepare one or more files for	access.
	  -c co-locate staged files if possible
	  -f refresh file access time even if the location is known
	  -s stage the files to	disk if	they are not online
	  -w whe files will be accessed	for modification
	  -p priority of the request, 0	(lowest) - 3 (highest)
	  -a abort the request
	  -e evict the file from disk cache

       cat [-o localfile] file
	  Print	contents of a file to stdout
	  -o print to the specified local file

       tail [-c	bytes] [-f] file
	  Output last part of files to stdout.
	  -c num_bytes out last	num_bytes
	  -f	       output appended data as file grows

       spaceinfo path
	  Get space statistics for given path.

RETURN CODES
       50  : generic error (e.g. config, internal, data, OS)

       51  : socket related error

       52  : postmaster	related	error

       53  : XRootD related error

       54  : redirection error

       55  : query response was	negative (this is not an error)

NOTES
       For the list of available environment variables please refere to	xrd-
       copy(1)

DIAGNOSTICS
       Errors yield an error message and a non-zero exit status.

LICENSE
       LGPL

SUPPORT	LEVEL
       The xrdfs command is supported by the XRootD Collaboration.  Contact
       information can be found	at

			   http://xrootd.org/contact.html

				    v4.10.0			      xrdfs(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | COMMANDS | RETURN CODES | NOTES | DIAGNOSTICS | LICENSE | SUPPORT LEVEL

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xrdfs&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help