Bug 779441

Summary:	systemd.mount man page is inaccurate / incomplete
Product:	[openSUSE] openSUSE 12.2	Reporter:	Christopher HORLER <cshorler>
Component:	Basesystem	Assignee:	Frederic Crozat <fcrozat>
Status:	VERIFIED INVALID	QA Contact:	E-mail List <qa-bugs>
Severity:	Minor
Priority:	P5 - None
Version:	Final
Target Milestone:	---
Hardware:	x86
OS:	openSUSE 12.2
Whiteboard:
Found By:	---	Services Priority:
Business Priority:		Blocker:	---
Marketing QA Status:	---	IT Deployment:	---

Description Christopher HORLER 2012-09-09 16:16:48 UTC

User-Agent:       Mozilla/5.0 (X11; Linux i686; rv:15.0) Gecko/20100101 Firefox/15.0

I have a filesystem that fails to mount, it's not critical for system operation SysV used to just report it and move on SystemD drops to a emergency console.

The manpage for systemd.mount states:
If an mount point is beneath another mount point in the file system hierarchy, a dependency between both units is created automatically.

On reading the source here:
http://cgit.freedesktop.org/systemd/systemd/tree/src/mount.c?id=v44
~ line 340 and onwards

Effective mount options are:  x-systemd-mount, x-systemd-automount, nofail etc.
(assuming our version is similar - I briefly checked applied patches on the build service package and didn't notice anything significant)

* Use of nofail changes the type of the dependency generated by SystemD from Requires to Wants.

- The systemd.mount man page doesn't have this information (relevance of nofail)
- The man page also states x-systemd.mount (which appears to be incorrect)
- The systemd.special man page indicates something else again in the local-fs.target section.


Reproducible: Always

Steps to Reproduce:
1. Set the hibernation flag on an NTFS partition (then mount won't be able to mount it without additional options).
2. Boot the system

system fails to initialise

3. Add x-systemd-mount,nofail to options in fstab.
4. Ctrl-D

system boots

Comment 1 Christopher HORLER 2012-09-09 16:47:59 UTC

Apologies, just read that we're supposed to refer to it as systemd, not SystemD.

The statement about systemd.special relates to the sentence:
In addition, systemd adds dependencies of type Wants to this target unit for those mounts listed in /etc/fstab that have the auto and comment=systemd.mount mount options set.

- defaults implies auto (?) but doesn't have this effect.

It might be better if it was all in systemd.mount

Comment 2 Frederic Crozat 2012-09-18 08:53:41 UTC

Information about nofail is in fstab(5) manpage (it is not systemd specific) and is all required in your case..

Comment 3 Christopher HORLER 2012-09-18 17:41:33 UTC

You're right, I failed to spot line 349.

Comment 4 Christopher HORLER 2012-09-18 17:42:44 UTC

closing