mirror of
https://github.com/iiab/iiab.git
synced 2025-03-09 15:40:17 +00:00
31 lines
2.1 KiB
ReStructuredText
31 lines
2.1 KiB
ReStructuredText
==============
|
|
usb_lib README
|
|
==============
|
|
|
|
**PLEASE SEE "Can teachers display their own content?" WITHIN http://FAQ.IIAB.IO FOR UP-TO-DATE DOCUMENTATION.**
|
|
|
|
This role implements functionality similar to LibraryBox, to mount "teacher content" from USB drives.
|
|
|
|
Users should have nearly immediate access to this "teacher content" (on all inserted USB drives) by browsing to http://box/usb
|
|
|
|
Automount is handled by usbmount, and scripts in this role look in the root of the mounted drive for...
|
|
|
|
* /usb
|
|
* /USB
|
|
* /share
|
|
* /Share
|
|
* /Piratebox/Share
|
|
|
|
...and if found, creates a symlink of the form /library/www/html/local_content/USBn pointing to /media/usbn — where n is generally one of {0, 1, 2, 3, 4, 5, 6, 7}.
|
|
|
|
USB drives must be formatted with one of the filesystems listed under "FILESYSTEMS=" at ``/etc/usbmount/usbmount.conf`` — these are specified on/around Line 76 of: `/opt/iiab/iiab/roles/usb_lib/tasks/install.yml <https://github.com/iiab/iiab/blob/master/roles/usb_lib/tasks/install.yml#L76>`_
|
|
|
|
IIAB will generally mount USB drives 'rw' allowing root to both read and write to them. In addition, in March 2021 (`PR #2715 <https://github.com/iiab/iiab/issues/2715>`_) Kolibri exports were enabled by also giving non-root users read and write access to VFAT/FAT32, NTFS and exFAT USB drives, using ``umask=0000`` (in /etc/usbmount/usbmount.conf) to override the ``umask=0022`` default. If however you prefer to restore usbmount's default, set ``usb_lib_umask0000_for_kolibri: False`` in `/etc/iiab/local_vars.yml <http://FAQ.IIAB.IO/#What_is_local_vars.yml_and_how_do_I_customize_it%3F>`_ (preferably do this prior to installing IIAB).
|
|
|
|
Official `usbmount 0.0.22 (2011-08-08) <https://github.com/rbrito/usbmount/releases>`_ documentation:
|
|
|
|
* https://github.com/hfuchs/usbmount/blob/master/README (2010-08-11)
|
|
* https://github.com/rbrito/usbmount/blob/master/README.md (2018-08-10)
|
|
* https://github.com/rbrito/usbmount/blob/master/usbmount.conf (2010-04-25)
|
|
|
|
Legacy warning: There is also a patch for problems with automount on Fedora 21+. Please note that as of 4.1.8-200.fc22.x86_64 not all USB drives will mount, even with this patch.
|