43817: update options in btrfs completion through to btrfs 4.17.1

1 files changed, 182 insertions, 66 deletions

diff --git a/Completion/Linux/Command/_btrfs b/Completion/Linux/Command/_btrfs
index 33b5c76f9..3ecebe62a 100644
--- a/Completion/Linux/Command/_btrfs
+++ b/Completion/Linux/Command/_btrfs
@@ -1,27 +1,25 @@
 #compdef btrfs
-# based on Btrfs v3.12+20131125
 
 local curcontext="$curcontext" curstate state line expl grp cmd cont shift ret=1
 local -a cmds_1 cmds_2 cmds_3 cmds_4 cmds_5 cmds_6 cmds_7 cmds_8 cmds_9 cmds_10
 local -a groups args
 
-groups=( subvolume filesystem device scrub balance inspect-internal
+groups=( subvolume filesystem device scrub balance inspect-internal property
          quota qgroup replace rescue check restore send receive
          help version )
-cmds_1=( create delete list snapshot get-default set-default find-new show help )
-cmds_2=( df show sync defragment resize label balance help )
-cmds_3=( add delete ready scan stats help )
+cmds_1=( create delete list snapshot get-default set-default find-new show sync help )
+cmds_2=( df du show sync defragment resize label usage help )
+cmds_3=( add delete remove ready scan stats usage help )
 cmds_4=( start cancel resume status help )
 cmds_5=( start pause cancel resume status )
-cmds_6=( inode-resolve logical-resolve subvolid-resolve rootid help )
-cmds_7=( enable disable rescan help )
-cmds_8=( assign remove create destroy show limit help )
-cmds_9=( start status cancel help )
-cmds_10=( chunk-recover super-recover )
+cmds_6=( dump-{super,tree} {inode,logical,subvolid}-resolve min-dev-size rootid tree-stats help )
+cmds_7=( get set list )
+cmds_8=( enable disable rescan help )
+cmds_9=( assign remove create destroy show limit help )
+cmds_10=( start status cancel help )
+cmds_11=( chunk-recover fix-device-size super-recover zero-log )
 
-[[ $words[2] = h(|e(|l(|p))) ]] && args=( '--full[display detailed help]' )
-
-_arguments -C "$args[@]" \
+_arguments -C -A "-*" "$args[@]" \
   '(- *)--help[print help information]' \
   '(- *)--version[print version information]' \
   '(--version)1: :->groups' \
@@ -37,10 +35,10 @@ while (( $#state )); do
     ;;
     cmds)
       grp=${groups[(i)$words[2]*]}
-      (( grp && grp <= 14 )) || return 1
+      (( grp && grp <= 16 )) || return 1
       cont=${groups[grp]}
       curcontext="${curcontext%:*:*}:$service-${cont}:"
-      if (( grp <= 10 )); then
+      if (( grp <= 11 )); then
         _wanted commands expl command compadd -a cmds_$grp && ret=0
         continue
       fi
@@ -48,9 +46,9 @@ while (( $#state )); do
     args)
       if [[ $curstate != cmds ]]; then
         grp=${groups[(i)$words[1]*]}
-        (( grp && grp <= 15 )) || return 1
+        (( grp && grp <= 16 )) || return 1
         cont=${groups[grp]}
-        if (( grp <= 10 )); then
+        if (( grp <= 11 )); then
           local group=cmds_$grp
           local cmd=${${(P)group}[(i)$words[2]*]}
           (( cmd )) || return 1
@@ -62,18 +60,20 @@ while (( $#state )); do
       fi
       args=( '(-)--help[print help information]' )
       case ${cont} in
-        filesystem:balance)
-          if (( CURRENT == 3 )); then
-            state+=cmds
-          else
-            shift words
-            (( CURRENT-- ))
-            state+=args
-          fi
-          continue
+        subvolume:create)
+          args+=(
+            '*-i[add the newly created subvolume to a qgroup]:qgroup'
+            '1:destination:->mounts'
+          )
+        ;;
+        subvolume:delete)
+          args+=(
+            '(-c --commit-after -C --commit-each)'{-c,--commit-after}'[wait for transaction commit at the end of the operation]'
+            '(-c --commit-after -C --commit-each)'{-C,--commit-each}'[wait for transaction commit after deleting each subvolume]'
+            '(-v --verbose)'{-v,--verbose}'[verbose output of operations]'
+            '1:subvolume:_files -/'
+          )
         ;;
-        subvolume:create) args+=( '1:destination:->mounts' );;
-        subvolume:delete) args+=( '1:subvolume:_files -/' );;
         subvolume:snapshot)
           args+=(
             '-r[readonly snapshot]'
@@ -91,53 +91,100 @@ while (( $#state )); do
             '-o[include only subvolumes below the path]'
             '-u[include UUID of subvolume]'
             '-q[include parent UUID of subvolume]'
+            '-R[include the uuid of the received snapshots]'
             '-t[print results as a table]'
             '-s[list only snapshot subvolumes]'
             '-r[list only readonly subvolumes]'
+            '-d[list deleted subvolumes that are not yet cleaned]'
             '-G[subvolume generation is more or less than]:gen: _guard "(|+|-)[0-9]#"'
             '-C[subvolume ogeneration is more or less than]:ogen: _guard "(|+|-)[0-9]#"'
-            '--sort=-[list in order]:sort:_values -s "," sort rootid gen ogen path'
+            '--sort=-[list in order]:order:_sequence compadd - rootid gen ogen path'
             '1:path:->mounts'
           )
         ;;
         subvolume:set-default) args+=( '1:id:_guard "[0-9]#" id' '2:path:->mounts' );;
-        subvolume:get-default) args+=( '1:path:_files -/' );;
+        subvolume:show)
+          args+=(
+            '(-r --rootid)'{-r,--rootid}'[rootid of the subvolume]'
+            '(-u --uuid)'{-u,--uuid}'[uuid of the subvolume]'
+            '1:subvolume path:_directories'
+          )
+        ;;
+        subvolume:sync) args+=( '-s[sleep between checks]:delay (seconds) [1]' );;
         subvolume:find-new) args+=( '1:subvol:_files -/' '2:lastgen: _message "last gen"' );;
+        (device|filesystem|qgroup):(df|du|show|usage))
+          args+=(
+            '--iec[use 1024 as a base]'
+            '--si[use 1000 as a base]'
+          )
+        ;|
+        (device|filesystem):(df|usage))
+          args+=(
+            '(-b --raw)'{-b,--raw}'[output raw numbers in bytes]'
+            '(-h --human-readable -H)'{-h,--human-readable}'[output human friendly numbers, base 1024]'
+            '(-h --human-readable -H)-H[output human friendly numbers, base 1000]'
+            '(-k --kbytes)'{-k,--kbytes}'[show sizes in KiB, or kB with --si]'
+            '(-m --mbytes)'{-m,--mbytes}'[show sizes in MiB, or MB with --si]'
+            '(-g --gbytes)'{-g,--gbytes}'[show sizes in GiB, or GB with --si]'
+            '(-t --tbytes)'{-t,--tbytes}'[show sizes in TiB, or TB with --si]'
+          )
+        ;|
+        (filesystem|qgroup):(du|show))
+          args+=(
+            '--raw[output raw numbers in bytes]'
+            '--human-readable[output human friendly numbers, base 1024]'
+            '--kbytes[show sizes in KiB, or kB with --si]'
+            '--mbytes[show sizes in MiB, or MB with --si]'
+            '--gbytes[show sizes in GiB, or GB with --si]'
+            '--tbytes[show sizes in TiB, or TB with --si]'
+          )
+        ;|
         filesystem:resize) args+=( '1:size:_guard "(|+|-)[0-9]#[GKM]"' '2:path:->mounts' );;
         filesystem:defragment)
           args+=(
             '-v[verbose]'
-            '-c[compress files while defragmenting]'
+            '-r[defragment files recursively]'
+            '-c+[compress files while defragmenting]::compression algorithm:(zlib lzo zstd)'
             '-r[defragment files recursively]'
             '-f[flush after defragmenting]'
             '-s[start position]:byte position'
             '-l[defragment limited number of bytes]:length (bytes)'
-            '-t[defragment only files over a certain size]:minimum size (bytes)'
+            '-t[defragment only files over a certain size]:minimum size (bytes) [32M]'
             '*:file:_files'
           )
         ;;
-        filesystem:label) args+=( '1:device:_files -g "*(d)"' '2:label' );;
+        filesystem:du) args+=( '(-s --summarize)'{-s,--summarize}'[display only a total for each argument]' );;
+        filesystem:label) args+=( '1:device:_files -g "*(-%)"' '2:new label' );;
         filesystem:show)
           args+=(
             '(1 -)'{-d,--all-devices}'[scan all devices in /dev]'
             '(1 -)'{-m,--mounted}'[show only mounted filesystems]'
+            '--raw[output raw numbers in bytes]'
+            '--human-readable[output human friendly numbers, base 1024]'
             '1: :_guard "^-*" uuid or label'
           )
         ;;
-        device:(add|delete))
+        filesystem:usage) args+=( '-T[show data in tabular format]' );;
+        device:(add|delete|ready|remove))
           args+=(
-            '1:device:_files -g "*(d)"'
+            '1:device:_files -g "*(-%)"'
             '2:path:->mounts'
             )
           [[ ${${(P)group}[cmd]} == add ]] &&
             args+=(
-              {-K,--nodiscard}'[do not perform discard]'
+              {-K,--nodiscard}"[don't perform discard]"
               {-f,--force}'[force overwrite of existing filesystem]'
             )
         ;;
-        device:scan) args+=( '(1 -)--all-devices[scan all devices in /dev]' '1:device:_files -g "*(d)"' );;
-        device:stats) args+=( "1:device or mountpoint:_files -g '*(d,/)'" '-z[reset stats when done]' );;
-        device:ready) args+=( '1:device: _files -g "*(d)"' );;
+        device:scan) args+=( '(1 -)'{-d,--all-devices}'[scan all devices in /dev]' '1:device:_files -g "*(-%)"' );;
+        device:stats)
+          args+=(
+            '(-c --check)'{-c,--check}'[return non-zero if any stat counter is not zero]'
+            '(-z --reset)'{-z,--reset}'[reset stats when done]'
+            "1:device or mountpoint:_files -g '*(-%,/)'"
+          )
+        ;;
+        device:ready) args+=( '1:device: _files -g "*(-%)"' );;
         scrub:(start|resume))
           args+=(
             "-B[don't background and print statistics at end]"
@@ -149,10 +196,18 @@ while (( $#state )); do
             '-n[set ioprio classdata]:classdata:(0 1 2 3 4 5 6 7)'
             '1:path or device:_files'
           )
-          [[ ${${(P)group}[cmd]} == start ]] && args+=( '-R[raw print mode]' )
+          [[ ${${(P)group}[cmd]} == start ]] && args+=(
+            '-f[force starting new scrub even if a scrub is already running]'
+          )
+        ;;
+        scrub:cancel) args+=( '1: : _guard "^-*" "path or device"' );;
+        scrub:status)
+          args+=(
+            '-d[separate statistics for each device]'
+            '-R[print raw stats]'
+            '1:path or device:_files'
+          )
         ;;
-        scrub:cancel) args+=( '1:path or device' );;
-        scrub:status) args+=( '-d[separate statistics for each device]' '1:path or device:_files' );;
         balance:start)
           args+=(
             '(-m -s)-d+[act on data chunks]:filter:->filters'
@@ -160,11 +215,21 @@ while (( $#state )); do
             '(-d -m)-s+[act on system chunks (only under -f)]:filters:->filters'
             '-v[verbose mode]'
             '-f[force reducing of metadata integrity]'
+            "--full-balance[don't print warning and don't delay start]"
+            '(--background --bg)'{--background,--bg}'[run balance operation asynchronously in the background]'
             '1:path:_files -/'
           )
         ;;
         balance:status) args+=( '-v[verbose mode]' '1:path:_files -/' );;
         balance:(pause|cancel|resume)) args+=( '1:path:_files -/' );;
+        property:set) args+=( '3:value' );&
+        property:get) args+=( '2:property:(ro label compression)' );&
+        property:list)
+          args+=(
+            '-t[specify object type]:object type:(subvol filesystem inode device)'
+            '1:object'
+          )
+        ;;
         quota:(enable|disable)) args+=( '1:path:_files -/' );;
         quota:rescan)
           args+=(
@@ -174,7 +239,10 @@ while (( $#state )); do
           )
         ;;
         qgroup:(assign|remove)) args+=( '1:source path:_files -/'
-          '2:destination path:_files -/' '3:path:_files -/' );;
+          '2:destination path:_files -/' '3:path:_files -/' );|
+        qgroup:assign) args+=( \!--rescan
+          "--no-rescan[don't do a rescan, even if the assignment will make the quotas inconsitent]" )
+        ;;
         qgroup:(create|destroy)) args+=( '1:qgroupid:' '2:path:_files -/' );;
         qgroup:show)
           args+=(
@@ -182,10 +250,11 @@ while (( $#state )); do
             '-c[print child qgroup id]'
             '-r[print max referenced size of qgroup]'
             '-e[print max exclusive size of qgroup]'