参数说明

  1. ➜  Desktop tar --help
  2. 用法: tar [选项...] [FILE]...
  3. GNU 'tar' saves many files together into a single tape or disk archive, and can
  4. restore individual files from the archive.
  6. Examples:
  7.   tar -cf archive.tar foo bar  # Create archive.tar from files foo and bar.
  8.   tar -tvf archive.tar         # List all files in archive.tar verbosely.
  9.   tar -xf archive.tar          # Extract all files from archive.tar.
  11.  本地文件名选择:
  13.   -C, --directory=DIR        改变至目录 DIR
  14.   -T, --files-from=FILE      从 FILE
  15.                              中获取文件名来解压或创建文件
  16.   -X, --exclude-from=FILE    排除 FILE 中列出的模式串
  17.       --add-file=FILE        添加指定的 FILE 至归档(如果名字以 -
  18.                              开始会很有用的)
  19.       --exclude=PATTERN      排除以 PATTERN 指定的文件
  20.       --exclude-backups      排除备份和锁文件
  21.       --exclude-caches       除标识文件本身外，排除包含
  22.                              CACHEDIR.TAG 的目录中的内容
  23.       --exclude-caches-all   排除包含 CACHEDIR.TAG 的目录
  24.       --exclude-caches-under 排除包含 CACHEDIR.TAG 的目录中所有内容
  26.       --exclude-ignore=FILE  若存在FILE,
  27.                              则从其中读取每个目录的例外匹配项
  28.       --exclude-ignore-recursive=FILE
  29.                              若存在FILE,
  30.                              则从其中为每个目录及其子目录读取需要排除的例外匹配项
  31.       --exclude-tag=FILE     除 FILE 自身外，排除包含 FILE
  32.                              的目录中的内容
  33.       --exclude-tag-all=FILE 排除包含 FILE 的目录
  34.       --exclude-tag-under=FILE   排除包含 FILE 的目录中的所有内容
  35.       --exclude-vcs          排除版本控制系统目录
  36.       --exclude-vcs-ignores  从VCS 忽略文件中读取排除匹配项
  37.       --no-null              禁用上一次的效果 --null 选项
  38.       --no-recursion         避免目录中的自动降级
  39.       --no-unquote           不要unquote 输入文件或成员名称
  40.       --no-verbatim-files-from   -T
  41.                              把以‘-’开始的文件作为选项(默认)
  42.       --null                 -T 读取以空终止的名字; 隐含
  43.                              --verbatim-files-from
  44.       --recursion            目录递归（默认）
  45.       --unquote              unquote 输入文件或成员名称(默认)
  46.       --verbatim-files-from  -T
  47.                              逐字读取文件名（不处理选项或进行转义）
  49.  文件名匹配选项(同时影响排除和包括模式串):
  51.       --anchored             模式串匹配文件名头部
  52.       --ignore-case          忽略大小写
  53.       --no-anchored          模式串匹配任意‘/’后字符（对
  54.                              exclusion 为默认值）
  55.       --no-ignore-case       匹配大小写(默认)
  56.       --no-wildcards         逐字匹配字符串
  57.       --no-wildcards-match-slash   通配符不匹配‘/’
  58.       --wildcards            使用通配符（对 exclusion 为默认值）
  59.       --wildcards-match-slash   通配符匹配‘/’（对 exclusion
  60.                              为默认值）
  62.  主操作模式:
  64.   -A, --catenate, --concatenate   追加 tar 文件至归档
  65.   -c, --create               创建一个新归档
  66.       --delete               从归档(非磁带！)中删除
  67.   -d, --diff, --compare      找出归档和文件系统的差异
  68.   -r, --append               追加文件至归档结尾
  69.   -t, --list                 列出归档内容
  70.       --test-label           测试归档卷标并退出
  71.   -u, --update               仅追加比归档中副本更新的文件
  72.   -x, --extract, --get       从归档中解出文件
  74.  操作修饰符:
  76.   -G, --incremental          处理老式的 GNU 格式的增量备份
  77.   -S, --sparse               高效处理离散文件
  78.       --check-device         当创建增量归档时检查设备号(默认)
  79.   -g, --listed-incremental=FILE   处理新式的 GNU 格式的增量备份
  80.       --hole-detection=TYPE  用于探测holes 的技术
  81.       --ignore-failed-read
  82.                              当遇上不可读文件时不要以非零值退出
  83.       --level=NUMBER         所创建的增量列表归档的输出级别
  84.   -n, --seek                 归档可检索
  85.       --no-check-device      当创建增量归档时不要检查设备号
  86.       --no-seek              归档不可检索
  87.       --occurrence[=NUMBER]  仅处理归档中每个文件的第 NUMBER
  88.                              个事件；仅当与以下子命令 --delete,
  89.                              --diff, --extract 或是 --list
  90.                              中的一个联合使用时，此选项才有效。而且不管文件列表是以命令行形式给出或是通过
  91.                              -T 选项指定的；NUMBER 值默认为 1
  92.       --sparse-version=MAJOR[.MINOR]
  93.                              设置所用的离散格式版本(隐含
  94.                              --sparse)
  96.  重写控制:
  98.   -U, --unlink-first         在解压要重写的文件之前先删除它们
  99.   -W, --verify               在写入以后尝试校验归档
  100.       --keep-directory-symlink   解压时保留已存在的目录符号链接
  101.       --keep-newer-files
  102.                              不要替换比归档中副本更新的已存在的文件
  103.   -k, --keep-old-files       解压时不替换存在的文件,
  104.                              而将其认为是错误
  105.       --no-overwrite-dir     保留已存在目录的元数据
  106.       --one-top-level[=DIR]  创建子目录以避免解压松散文件
  107.       --overwrite            解压时重写存在的文件
  108.       --overwrite-dir
  109.                              解压时重写已存在目录的元数据(默认)
  111.       --recursive-unlink     解压目录之前先清除目录层次
  112.       --remove-files         在添加文件至归档后删除它们
  113.       --skip-old-files
  114.                              解压时不替换存在的文件，而是自动忽略
  116.  选择输出流：
  118.   -O, --to-stdout            解压文件至标准输出
  119.       --ignore-command-error 忽略子进程的退出代码
  120.       --no-ignore-command-error
  121.                              将子进程的非零退出代码认为发生错误
  122.       --to-command=COMMAND
  123.                              将解压的文件通过管道传送至另一个程序
  125.  操作文件属性:
  127.       --atime-preserve[=METHOD]
  128.                              在输出的文件上保留访问时间，要么通过在读取(默认
  129.                              METHOD=‘replace’)后还原时间，要不就不要在第一次(METHOD=‘system’)设置时间
  130.       --clamp-mtime          当文件比 --mtime
  131.                              指定的文件更新时仅更新时间
  132.       --delay-directory-restore
  133.                              直到解压结束才设置修改时间和所解目录的权限
  134.       --group=名称         强制将 NAME
  135.                              作为所添加的文件的组所有者
  136.       --group-map=FILE       用FILE 映射文件所有者GIDs 和名字
  137.       --mode=CHANGES         强制将所添加的文件(符号)更改为权限
  138.                              CHANGES
  139.       --mtime=DATE-OR-FILE   从 DATE-OR-FILE 中为添加的文件设置
  140.                              mtime
  141.   -m, --touch                不要解压文件的修改时间
  142.       --no-delay-directory-restore
  143.                              取消 --delay-directory-restore 选项的效果
  144.       --no-same-owner
  145.                              将文件解压为您所有(普通用户默认此项)
  146.       --no-same-permissions
  147.                              从归档中解压权限时使用用户的掩码位(默认为普通用户服务)
  148.       --numeric-owner        总是以数字代表用户/组的名称
  149.       --owner=名称         强制将 NAME
  150.                              作为所添加的文件的所有者
  151.       --owner-map=FILE       用FILE 映射文件所有者UIDs 和名字
  152.   -p, --preserve-permissions, --same-permissions
  153.                              解压文件权限信息(默认只为超级用户服务)
  154.       --same-owner
  155.                              尝试解压时保持所有者关系一致(超级用户默认此项)
  156.   -s, --preserve-order, --same-order
  157.                              成员参数按归档中的文件顺序列出
  158.       --sort=ORDER           目录排序顺序: none(默认), name 或inode
  160.  操作extended 文件属性:
  162.       --acls                 开启 POSIX ACLs 支持
  163.       --no-acls              关闭 POSIX ACLs 支持
  164.       --no-selinux           关闭 SELinux 上下文支持
  165.       --no-xattrs            关闭extended 属性支持
  166.       --selinux              开启 SELinux 上下文支持
  167.       --xattrs               开启extended 属性支持
  168.       --xattrs-exclude=MASK  为xattr 关键字指定排除匹配项
  169.       --xattrs-include=MASK  为xattr 关键字指定包含匹配项
  171.  设备选择和切换：
  173.   -F, --info-script=名称, --new-volume-script=名称
  174.                              在每卷磁带最后运行脚本(隐含 -M)
  175.   -L, --tape-length=NUMBER   写入 NUMBER × 1024 字节后更换磁带
  176.   -M, --multi-volume         创建/列出/解压多卷归档文件
  177.   -f, --file=ARCHIVE         使用归档文件或 ARCHIVE 设备
  178.       --force-local
  179.                              即使归档文件存在副本还是把它认为是本地归档
  180.       --rmt-command=COMMAND  使用指定的 rmt COMMAND 代替 rmt
  181.       --rsh-command=COMMAND  使用远程 COMMAND 代替 rsh
  182.       --volno-file=FILE      使用/更新 FILE 中的卷数
  184.  设备分块:
  186.   -B, --read-full-records    读取时重新分块(只对 4.2BSD 管道有效)
  187.   -b, --blocking-factor=BLOCKS   每个记录 BLOCKS x 512 字节
  188.   -i, --ignore-zeros         忽略归档中的零字节块(即文件结尾)
  189.       --record-size=NUMBER   每个记录的字节数 NUMBER，乘以 512
  191.  选择归档格式:
  193.   -H, --format=FORMAT        创建指定格式的归档
  195.  FORMAT 是以下格式中的一种:
  197.     gnu                      GNU tar 1.13.x 格式
  198.     oldgnu                   GNU 格式，其中 tar 版本 <= 1.12
  199.     pax                      POSIX 1003.1-2001 (pax) 格式
  200.     posix                    等同于 pax
  201.     ustar                    POSIX 1003.1-1988 (ustar) 格式
  202.     v7                       旧的 V7 tar 格式
  204.   -V, --label=TEXT           创建带有卷名 TEXT
  205.                              的归档；在列出/解压时，使用 TEXT
  206.                              作为卷名的模式串
  207.       --old-archive, --portability
  208.                              等同于 --format=v7
  209.       --pax-option=关键字[[:]=值][,关键字[[:]=值]]...
  210.                              控制 pax 关键字
  211.       --posix                等同于 --format=posix
  213.  压缩选项:
  215.   -I, --use-compress-program=PROG
  216.                              通过 PROG 过滤(必须是能接受 -d
  217.                              选项的程序)
  218.   -J, --xz                   通过 xz 过滤归档
  219.   -Z, --compress, --uncompress   通过 compress 过滤归档
  220.   -a, --auto-compress        使用归档后缀名来决定压缩程序
  221.   -j, --bzip2                通过 bzip2 过滤归档
  222.       --lzip                 通过 lzip 过滤归档
  223.       --lzma                 通过 lzma 过滤归档
  224.       --lzop                 通过 lzop 过滤归档
  225.       --no-auto-compress     不使用归档后缀名来决定压缩程序
  226.   -z, --gzip, --gunzip, --ungzip   通过 gzip 过滤归档
  227.       --zstd                 通过 zstd 过滤归档
  229.  本地文件选择:
  231.   -K, --starting-file=MEMBER-NAME
  232.                              从归档中的 MEMBER-NAME
  233.                              成员处开始读取归档
  234.   -N, --newer=DATE-OR-FILE, --after-date=DATE-OR-FILE
  235.                              只保存比 DATE-OR-FILE 更新的文件
  236.   -P, --absolute-names       不要从文件名中清除引导符‘/’
  237.       --backup[=CONTROL]     在删除前备份，选择 CONTROL 版本
  238.   -h, --dereference
  239.                              跟踪符号链接；将它们所指向的文件归档并输出
  240.       --hard-dereference
  241.                              跟踪硬链接；将它们所指向的文件归档并输出
  242.       --newer-mtime=DATE     当只有数据改变时比较数据和时间
  243.       --one-file-system      创建归档时保存在本地文件系统中
  244.       --suffix=STRING        在删除前备份，除非被环境变量
  245.                              SIMPLE_BACKUP_SUFFIX
  246.                              覆盖，否则覆盖常用后缀(‘’)
  248.  文件名变换:
  250.       --strip-components=NUMBER   解压时从文件名中清除 NUMBER
  251.                              个引导部分
  252.       --transform=EXPRESSION, --xform=EXPRESSION
  253.                              使用 sed 代替 EXPRESSION
  254.                              来进行文件名变换
  256.  提示性输出:
  258.   -R, --block-number         每个信息都显示归档内的块数
  259.       --checkpoint[=NUMBER]  每隔 NUMBER
  260.                              个记录显示进度信息(默认为 10 个)
  261.       --checkpoint-action=ACTION   在每个检查点上执行 ACTION
  262.       --full-time            按文件原本时间格式打印
  263.       --index-file=FILE      将详细输出发送至 FILE
  264.   -l, --check-links
  265.                              只要不是所有链接都被输出就打印信息
  266.       --no-quote-chars=STRING   禁用来自 STRING 的字符引用
  267.       --quote-chars=STRING   来自 STRING 的额外的引用字符
  268.       --quoting-style=STYLE  设置名称引用风格；有效的 STYLE
  269.                              值请参阅以下说明
  270.       --show-defaults        显示 tar 默认选项
  271.       --show-omitted-dirs
  272.                              列表或解压时，列出每个不匹配查找标准的目录
  273.       --show-snapshot-field-ranges
  274.                              显示快照文件区的有效范围
  275.       --show-transformed-names, --show-stored-names
  276.                              显示变换后的文件名或归档名
  277.       --totals[=SIGNAL]      处理归档后打印出总字节数；当此
  278.                              SIGNAL 被触发时带参数 -
  279.                              打印总字节数；允许的信号为:
  280.                              SIGHUP，SIGQUIT，SIGINT，SIGUSR1 和
  281.                              SIGUSR2；同时也接受不带 SIG
  282.                              前缀的信号名称
  283.       --utc                  以 UTC 格式打印文件修改时间
  284.   -v, --verbose              详细地列出处理的文件
  285.       --warning=KEYWORD      警告控制
  286.   -w, --interactive, --confirmation
  287.                              每次操作都要求确认
  289.  兼容性选项:
  291.   -o                         创建归档时，相当于
  292.                              --old-archive；展开归档时，相当于
  293.                              --no-same-owner
  295.  其它选项:
  297.   -?, --help                 显示此帮助列表
  298.       --restrict             禁用某些潜在的有危险的选项
  299.       --usage                显示简短的用法说明
  300.       --version              打印程序版本
  302. 长选项和相应短选项具有相同的强制参数或可选参数。
  304. The backup suffix is '~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX.
  305. The version control may be set with --backup or VERSION_CONTROL, values are:
  307.   none, off       never make backups
  308.   t, numbered     make numbered backups
  309.   nil, existing   numbered if numbered backups exist, simple otherwise
  310.   never, simple   always make simple backups
  312. --quoting-style 选项的有效参数为:
  314.   literal
  315.   shell
  316.   shell-always
  317.   shell-escape
  318.   shell-escape-always
  319.   c
  320.   c-maybe
  321.   escape
  322.   locale
  323.   clocale
  325. 此 tar 默认为:
  326. --format=gnu -f- -b20 --quoting-style=escape --rmt-command=/usr/lib/tar/rmt.exe
  327. --rsh-command=/usr/bin/rsh

—xform的用法

--xform 使用 sed 代替 EXPRESSION 来进行文件名变换

➜  Desktop tree test
test
├── electerm-0.26.73-win-x64.tar.gz
├── GraphQL.pdf
└── README.md

tar czvf xsom.tar.gz test
test/
test/electerm-0.26.73-win-x64.tar.gz
test/GraphQL.pdf
test/README.md

tar czvf xsom.tar.gz test --xform='s|test|xsom|g'
xsom/
xsom/electerm-0.26.73-win-x64.tar.gz
xsom/GraphQL.pdf
xsom/README.md

注：--xform把test的目录改成了xsom，上面的case很好的说明了这个问题