docs-xml/manpages/mvxattr.1.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="mvxattr.1">
   4
   5 <refmeta>
   6         <refentrytitle>mvxattr</refentrytitle>
   7         <manvolnum>1</manvolnum>
   8         <refmiscinfo class="source">Samba</refmiscinfo>
   9         <refmiscinfo class="manual">User Commands</refmiscinfo>
  10         <refmiscinfo class="version">&doc.version;</refmiscinfo>
  11 </refmeta>
  12
  13
  14 <refnamediv>
  15         <refname>mvxattr</refname>
  16         <refpurpose>Recursively rename extended attributes</refpurpose>
  17 </refnamediv>
  18
  19 <refsynopsisdiv>
  20         <cmdsynopsis>
  21                 <command>mvxattr</command>
  22                 <arg choice="req">-s STRING, --from=STRING</arg>
  23                 <arg choice="req">-d STRING, --to=STRING</arg>
  24                 <arg choice="opt">-l, --follow-symlinks</arg>
  25                 <arg choice="opt">-p, --print</arg>
  26                 <arg choice="opt">-v, --verbose</arg>
  27                 <arg choice="opt">-f, --force</arg>
  28                 <arg choice="req">PATH [PATH ...]</arg>
  29         </cmdsynopsis>
  30 </refsynopsisdiv>
  31
  32 <refsect1>
  33         <title>DESCRIPTION</title>
  34
  35         <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
  36         <manvolnum>1</manvolnum></citerefentry> suite.</para>
  37
  38         <para>mvxattr is a simple utility to recursively rename extended
  39         attributes.</para>
  40
  41         <para>By default all symlinks are ignored, use <option>-l</option> to
  42         follow them.</para>
  43 </refsect1>
  44
  45 <refsect1>
  46         <title>OPTIONS</title>
  47
  48         <variablelist>
  49         <varlistentry>
  50                 <term>-s STRING, --from=STRING</term>
  51                 <listitem><para>Source xattr name</para></listitem>
  52         </varlistentry>
  53
  54         <varlistentry>
  55                 <term>-d STRING, --to=STRING</term>
  56                 <listitem><para>Destination xattr name</para></listitem>
  57         </varlistentry>
  58
  59         <varlistentry>
  60                 <term>-l, --follow-symlinks</term>
  61                 <listitem><para>Follow symlinks, the default is to ignore
  62                 them.</para></listitem>
  63         </varlistentry>
  64
  65         <varlistentry>
  66                 <term>-p, --print</term>
  67                 <listitem><para>Print files where the xattr got renamed.</para></listitem>
  68         </varlistentry>
  69
  70         <varlistentry>
  71                 <term>-v, --verbose</term>
  72                 <listitem><para>Print files as they are checked.</para></listitem>
  73         </varlistentry>
  74
  75         <varlistentry>
  76                 <term>-f, --force</term>
  77                 <listitem><para>Force overwriting of destination xattr.</para></listitem>
  78         </varlistentry>
  79         </variablelist>
  80
  81 </refsect1>
  82
  83 <refsect1>
  84         <title>VERSION</title>
  85
  86         <para>This man page is part of version &doc.version; of the Samba suite.</para>
  87 </refsect1>
  88
  89 <refsect1>
  90         <title>AUTHOR</title>
  91
  92         <para>The original Samba software and related utilities were created by
  93         Andrew Tridgell. Samba is now developed by the Samba Team as an Open
  94         Source project similar to the way the Linux kernel is developed.</para>
  95
  96         <para>The mvxattr manpage was written by Ralph Boehme.</para>
  97
  98 </refsect1>
  99
 100 </refentry>