mounting: samba/ntfs/dislocker added

wiki/docker-images/samba.md

@@ -1,5 +1,7 @@
 # samba
 
+This is a docker container for a [Samba](../samba.md)
+server.
 The official container and documentation was made by [dperson](https://hub.docker.com/r/samba).
 
 ## Set-up

wiki/linux/dislocker.md

@@ -10,9 +10,12 @@ package.
 
 ## Usage
 
-For the mounting to work two directories are required.
+### Manual Mounting of Bitlocker Partition
+
+For the [mounting](/wiki/linux/filesystems.md#mounting) to work two directories
+are required.
 One to mount the `dislocker-file` (`/mnt/bitlocker`) and one to mount the
-windows volume (`/mnt/windows`).
+[windows volume](/wiki/linux/ntfs.md#manual-mounting) (`/mnt/windows`).
 The device which holds the windows partition is assumed to be calles
 `/dev/sdc1`.
 
@@ -20,18 +23,33 @@ The following command mounts the `dislocker` file to `/mnt/bitlocker`.
 Make sure to replace the password in the following command.
 There is no gap between the `-u` and the password:
 `sudo dislocker /dev/sdc1 -u<password> -- /mnt/bitlocker`.
-
+If the Bitlocker partition is set up using a `.BEK` file then the follwing
+command takes the path to the file in:
+`sudo dislocker /dev/sdb2 -f <path to bek-file> -- /mnt/bitlocker`
 Alternatively a recovery key can be used:
-`sudo dislocker /dev/sdc1 -p<recovery_password> -- /mnt/bitlocker`.
+`sudo dislocker /dev/sdc1 -p<recovery password> -- /mnt/bitlocker`.
 
-Afterwards the `dislocker-file` can be mounted to the `/mnt/windows` directory:
-`sudo mount -o loop /mnt/bitlocker/dislocker-file /mnt/windows`.
-It is possible that the partition uses the NTFS which requires the `ntfs-3g`
-package to be installed to work with linux and specified in the command:
-`sudo mount -t ntfs-3g -o loop /mnt/bitlocker/dislocker-file /mnt/windows`.
-If the partition to mount is bootable or contains a windows system the
-hibernation and fast boot have to be disabled to mount the partition with write
-access.
+Afterwards the `dislocker-file` can be mounted to the `/mnt/windows` directory
+or another mount point as described in the
+[NTFS entry](/wiki/linux/ntfs.md#manual-mounting).
 
-Following these commands the windows partition can be found mounted on
+### Automatic Mounting at Boot
+
+Using [fstab](/wiki/linux/filesystems.md#mounting) the partition encrypted with
+Bitlocker can be automatically mounted.
+The following lines have to be adapted and written into
+[`/etc/fstab`](/wiki/linux/filesystems.md#mounting).
+In this case the intermediary dislocker file `dislocker-file` is mounted to
+`/mnt/bitlocker`.
+
+```txt
+UUID=<partition uuid> /mnt/bitlocker fuse.dislocker bekfile=<path to bek-file>,nofail 0 0
+```
+
+After that a line to mount the `dislocker-file` as a [NTFS](./ntfs.md) partition
+has to be added as described in
+[the NTFS entry](/wiki/linux/ntfs.md#automatic-mounting).
+In this case the specified partition to mount is
+`/mnt/bitlocker/dislocker-file`.
+The mount point can be chosen according to preference - for example
 `/mnt/windows`.

wiki/linux/filesystems.md

@@ -0,0 +1,36 @@
+# File Systems
+
+File systems control how data on a drive is stored.
+
+- [NTFS](./ntfs.md) is a proprietary file system used by Windows
+- [Samba](./samba.md) is free windows interoperability software that is not a
+  classic file system can be mounted so it will be mentioned here
+
+## Mounting
+
+Mounting a file system makes the files of it accessible to the user.
+The command `mount` is used to manually and temporarily mount file systems.
+Automatic mounting is done by changing the file `/etc/fstab`.
+
+The exact guide on how to mount specific file systems can be found in their
+respecitive wiki entries.
+The following describes the general basics of mounting temporarily and
+persistently.
+
+The basic mount command for temporarily accessing a file system is the
+following:
+`mount <path to partition> <path to mount point>`
+All partitions can be found at `/dev` and the standard mount point is `/mnt` and
+its subfolders.
+
+For automatic mounting the following line has to be adapted and added to the
+file `/etc/fstab`
+`<specified partition>	<path to mount point>   <file system> <additional options>  <dump flag> <fsck order>`
+The partition can be specified by UUID - which can be found at
+`/dev/disk/by-uuid` or other identifiers aswell as the simple path to it (for
+example `/dev/sda1`).
+The file system varies and a file system specific guide on how to mount them
+can be found in their respective entries.
+The dump flag signals if the file system should be dumped.
+The `fsck` order signals if a file system should be checked at boot.
+Boot partitions should be flagged with a `1` for this reason, otherwise `0`.

wiki/linux/ntfs.md

@@ -0,0 +1,30 @@
+# NTFS
+
+NTFS is the proprietary [file system](./filesystems.md) of Windows.
+
+## Setup
+
+For the usage of NTFS file systems the `ntfs-3g` package - available on most
+distributions - has to be installed.
+
+## Usage
+
+### Manual Mounting
+
+Partitions using [NTFS] can be mounted on Linux based operating systems by
+running the following command:
+`mount -t ntfs-3g -o loop <path to partition> <path to mount point>`.
+If the partition to mount is bootable or contains a windows system the
+hibernation and fast boot have to be disabled to mount the partition with write
+access.
+
+### Automatic Mounting
+
+For the usage of NTFS file systems the `ntfs-3g` package - available on most
+distributions - has to be installed.
+To automount partitions with NTFS the following line has to be adapted and added
+to `/etc/fstab`:
+`<specified partition> <path to mount point> ntfs-3g nofail,windows_names,big_writes 0 0`
+If the partition to mount is bootable or contains a windows system the
+hibernation and fast boot have to be disabled to mount the partition with write
+access.

wiki/linux/samba.md

@@ -0,0 +1,27 @@
+# Samba
+
+[Samba](../samba.md) is the standard Windows interoperability suite for linux
+and unix.
+
+## Usage
+
+### Manual Mounting
+
+The mounting of Samba shares requires a package containing `mount.cifs` in many
+distributions packaged in the `cifs-utils` package to be installed.
+Samba shares then can be mounted by adapting and running the following example:
+`mount -t cifs //<server address>/<share name> <path to mount point> -o username=<username>,password=<password>`
+
+### Automatic Mounting
+
+The mounting of Samba shares requires a package containing `mount.cifs` in many
+distributions packaged in the `cifs-utils` package to be installed.
+To automount Samba shares the following line has to be adapted and added
+to `/etc/fstab`:
+`//<server address>/<share name>   <path to mountpoint>     cifs,nofail     credentials=<path to authentication file>      0 0`.
+An authentication file looks like the following:
+
+```txt
+username=<username>
+password=<password>
+```

wiki/samba.md

@@ -0,0 +1,15 @@
+# Samba
+
+[Samba](https://www.samba.org/) is a free software implementation of the SMB
+protocol which provides file and print services.
+Samba is the standard Windows interoperability suite for Linux and Unix.
+
+## Setup
+
+The software can be setup via docker with the
+[samba image](./docker-images/samba.md).
+
+## Usage
+
+For the Linux based operating systems the handling of Samba shares is taken care
+of by [mount.cifs](./linux/samba.md).