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] [-C]	[dirname]
	  Get directory	listing.
	  -l stat every	entry and print	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
	  -C checksum every entry

       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> [<paths>]
	  Get info about the file(s) or	directory(ies).
	  -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	cancellation
	  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> [<filenames>]
	  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 when 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] files
	  Print	contents of one	or mote	files 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.

       xattr <path> <code> <params>
	  Operation on extended	attributes. Codes:
	  set	      <attr>   Set extended attribute;
			       <attr> is string	of form	name=value
	  get	      <name>   Get extended attribute.
	  del	      <name>   Delete extended attribute.
	  list		       List extended attributes.

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

				    v5.6.9			      xrdfs(1)

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

home | help