Description
Area:
Disk Utility
Summary:
The diskutil apfs has no verbs or documentation indicating how to add or modify the 'reserved space' or quota of an existing APFS volume.
For example, it does not appear possible to create reserved space or specify a quota for the /Volumes/Macintosh HD APFS volume that is created by the OS installer without removing the volume and re-creating it.
Steps to Reproduce:
- Launch the Terminal.app from /Applications/Utilities
man diskutil- Find the corresponding section for APFS and related verbs
- Look for documentation/verbs on modifying an existing volume to add/remove/modify a reserved space allocation or quota
Expected Results:
diskutil apfs should have a means to modify/add/remove a quota or reserved space allocation.
Observed Results:
There is no documented means, or any verb found in the man diskutil page for modifying existing APFS volumes without deleting the volume first.
Deleting a volume is not always a desired step in modifying APFS volumes - for example, modifying the APFS volume containing Macintosh HD to have a quota and or reserve of nGB appears to require the APFS volume be deleted first.
diskutil apfs should have a verb (perhaps modifyVolume) and two additional parameters for the modifyVolume verb such as -quota and -reserve.
For example, if a volume has been created using:
diskutil apfs addVolume disk1 Data -quota 50G -reserve 10G
To remove the quota and reserve:
diskutil apfs modifyVolume disk1s5 Data -quota 0 -reserve -0
To modify the quota and reserve to different sizes:
diskutil apfs modifyVolume disk1s5 Data -quota 40G -reserve 15G
To add a quota and reserve to an existing APFS volume (assuming Macintosh HD volume is on disk1s1):
diskutil apfs modifyVolume disk1s1 "Macintosh HD" -quota 50G -reserve 30G
It may not be strictly necessary to include the Volume name in the modifyVolume parameters.
Version:
macOS 10.13/17A352a
Product Version: 10.13
Created: 2017-08-29T02:49:43.237670
Originated: 2017-08-26T00:00:00
Open Radar Link: http://www.openradar.me/34096467
Description
Area:
Disk Utility
Summary:
The
diskutil apfshas no verbs or documentation indicating how to add or modify the 'reserved space' or quota of an existing APFS volume.For example, it does not appear possible to create reserved space or specify a quota for the
/Volumes/Macintosh HDAPFS volume that is created by the OS installer without removing the volume and re-creating it.Steps to Reproduce:
man diskutilExpected Results:
diskutil apfsshould have a means to modify/add/remove a quota or reserved space allocation.Observed Results:
There is no documented means, or any verb found in the
man diskutilpage for modifying existing APFS volumes without deleting the volume first.Deleting a volume is not always a desired step in modifying APFS volumes - for example, modifying the APFS volume containing
Macintosh HDto have a quota and or reserve of nGB appears to require the APFS volume be deleted first.diskutil apfsshould have a verb (perhapsmodifyVolume) and two additional parameters for themodifyVolumeverb such as-quotaand-reserve.For example, if a volume has been created using:
diskutil apfs addVolume disk1 Data -quota 50G -reserve 10GTo remove the quota and reserve:
diskutil apfs modifyVolume disk1s5 Data -quota 0 -reserve -0To modify the quota and reserve to different sizes:
diskutil apfs modifyVolume disk1s5 Data -quota 40G -reserve 15GTo add a quota and reserve to an existing APFS volume (assuming
Macintosh HDvolume is on disk1s1):diskutil apfs modifyVolume disk1s1 "Macintosh HD" -quota 50G -reserve 30GIt may not be strictly necessary to include the Volume name in the
modifyVolumeparameters.Version:
macOS 10.13/17A352a
Product Version: 10.13
Created: 2017-08-29T02:49:43.237670
Originated: 2017-08-26T00:00:00
Open Radar Link: http://www.openradar.me/34096467