View source for QUERY FREE SPACE (Myth Protocol)

== QUERY_FREE_SPACE ==

=== Present in Protocol Versions ===
All?

=== Description ===
Queries the backend for information on the local storage devices

== QUERY_FREE_SPACE_LIST ==

=== Present in Protocol Versions ===
Beginning with version 40?

=== Description ===
Queries the backend for information on all storage devices.  Paths existing on the same physical drive will be combined, along with a 'TotalDislSpace' summary as the last device.

== General ==

=== Arguments ===
'''Command arguments''': none

'''List arguments''': none

=== Examples ===
Command:
<pre>16      QUERY_FREE_SPACE</pre>
Response:
<pre>34      0[]:[]196014080[]:[]0[]:[]29351936</pre>
Response from proto version 34 with storage groups:
<pre>170     theP4[]:[]/media/mainlv/mythtv[]:[]1[]:[]-1[]:[]0[]:[]63799104[]:[]0[]:[]61376252[]:[]theP4[]:[]/media/disk/mythtv/data[]:[]0[]:[]-1[]:[]0[]:[]75884640[]:[]0[]:[]73477128</pre>
Response from proto version 47 with storage group ID and file system block size:
<pre>206     theP4[]:[]/media/mainlv/mythtv[]:[]1[]:[]-1[]:[]12[]:[]131072[]:[]0[]:[]63799104[]:[]0[]:[]61376252[]:[]theP4[]:[]/media/disk/mythtv/data[]:[]0[]:[]-1[]:[]13[]:[]131072[]:[]0[]:[]75884640[]:[]0[]:[]73477128</pre>
Response from proto version 66:
<pre>182     theP4[]:[]/media/mainlv/mythtv[]:[]1[]:[]-1[]:[]12[]:[]131072[]:[]63799104[]:[]61376252[]:[]theP4[]:[]/media/disk/mythtv/data[]:[]0[]:[]-1[]:[]13[]:[]131072[]:[]75884640[]:[]73477128</pre>


=== Returns ===

#Hostname of the drive
#Path of the drive
#Whether the drive is local to the connected backend
#Drive number (always -1 for QUERY_FREE_SPACE)
#Storage group ID
#Filesystem block size (in bytes)
#The total size of the drive, in 1K blocks (64-bit value)
#The space used on the drive, in 1K blocks (64-bit value)


=== Changelog ===
{| border="1" cellspacing="0" cellpadding="5" style="border-collapse:collapse; border-color:#8eabd0; background:#e7edf5"
|- style="background: lightsteelblue"
|+
! version !! changeset !! field count !! description
|-
| 17 || {{changeset|6482}} || 9
| initial version
|-
| 47 || {{changeset|21298}} || 10
| add filesystem block size
|-
| 66 || {{gitcommit|1508085e|mythtv|v0.25pre-2052-g1508085}} || 8
| The sizes are now returned as single 64 bit numbers rather than split into 32 bit numbers.
|-
|}

[[Category:Myth Protocol Commands]]