-
Notifications
You must be signed in to change notification settings - Fork 543
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[Config] Mount options fstab format is for Linux #432
Conversation
The fstab format (https://wiki.archlinux.org/index.php/Fstab) may be appropriate for Linux, but may not be appropriate for other OS platforms. This edit clarifies that mount options for Linux MUST be in fstab format but leaves the format of options as an open question for other operating systems to clarify. Signed-off-by: Rob Dolin <RobDolin@microsoft.com>
@@ -46,7 +46,8 @@ The parameters are similar to the ones in [the Linux mount system call](http://m | |||
* **`destination`** (string, required) Destination of mount point: path inside container. | |||
* **`type`** (string, required) Linux, *filesystemtype* argument supported by the kernel are listed in */proc/filesystems* (e.g., "minix", "ext2", "ext3", "jfs", "xfs", "reiserfs", "msdos", "proc", "nfs", "iso9660"). Windows: ntfs | |||
* **`source`** (string, required) a device name, but can also be a directory name or a dummy. Windows, the volume name that is the target of the mount point. \\?\Volume\{GUID}\ (on Windows source is called target) | |||
* **`options`** (list of strings, optional) in the fstab format [https://wiki.archlinux.org/index.php/Fstab](https://wiki.archlinux.org/index.php/Fstab). | |||
* **`options`** (list of strings, optional) in a platform-appropriate format for each operating system. | |||
For the Linux OS, if present, options MUST be in the fstab format [https://wiki.archlinux.org/index.php/Fstab](https://wiki.archlinux.org/index.php/Fstab). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks fine to me, although it would be nice to specify what other platforms expect so authors know what to put in here. @JLB13, @anuthan, can you clarify what Solaris wants?
Also, I'd like to replace the Arch link with a link to the man page, but I'm happy to file that in a subsequent PR if you don't want to roll it in here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
And as a minor copy-edit, maybe “When platform.os
is linux
, any entries MUST be in the fstab format.”, to avoid folks associating “if present” with Linux, instead of associating it with the options.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Solaris is fine with a format similar to the Linux one. I guess that could be "Linux or Unix", for what it's worth. I would support platform-specific mounts, I'm not sure I like trying to enforce it in a global scope.
The fstab format (https://wiki.archlinux.org/index.php/Fstab) may be appropriate for Linux, but may not be appropriate for other OS platforms. This edit clarifies that mount options for Linux (and Solaris per @JLB13) MUST be in fstab format but leaves the format of options as open for other operating systems to clarify. This replaces PR opencontainers#432 Signed-off-by: Rob Dolin <RobDolin@microsoft.com>
Replaced by PR #439 |
The fstab format (https://wiki.archlinux.org/index.php/Fstab) may be appropriate for Linux, but may not be appropriate for other OS platforms.
This edit clarifies that mount options for Linux MUST be in fstab format but leaves the format of options as an open question for other operating systems to clarify.
Signed-off-by: Rob Dolin RobDolin@microsoft.com