freebsd-ports/deskutils/calibre/pkg-message
2019-08-13 16:01:59 +00:00

71 lines
1.9 KiB
Text

[
{ type: install
message: <<EOM
NOTE: Calibre requires Hal to be running for access to devices. The user who
is running Calibre also needs to be able to mount devices. For non-root users,
this means modifying %%PREFIX%%/etc/PolicyKit/PolicyKit.conf and adding the
policy there.
To allow a single user named "example" to mount removable devices, add the
following:
<match action="org.freedesktop.hal.storage.mount-removable">
<match user="example">
<return result="yes" />
</match>
</match>
Additional users will each need their own <match user="user"> block with a
"yes" return result.
To permit all accounts to mount removable devices (allowing a denial of access
attack) add the following:
<match action="org.freedesktop.hal.storage.mount-removable">
<return result="yes" />
</match>
---
In addition to the above, for USB and MTP devices the user needs
to be able to access the device node in /dev.
to be aware of USB devices attached to the machine, the user needs
to be a member of the operator group:
# pw groupmod operator -m yourusername
Then, add the following to /etc/devfs.rules, or create this file
if it does not exist yet:
[system=10]
add path 'usb/*' mode 0660 group operator
To load these new rules, add the following to /etc/rc.conf:
devfs_system_ruleset="system"
Then, restart devfs
# service devfs restart
---
If you are using an Android device as your e-book reader, please note
that the stock Google Books app uses a storage format that is not
supported by calibre. The calibre FAQ recommends that either of the
free apps Aldiko or WordPlayer are used instead.
---
A basic startup script for calibre-server has been installed.
It can be customized and configured using the flags described in the
headers of the startup script.
The command line options are documented here:
https://manual.calibre-ebook.com/generated/en/calibre-server.html
EOM
}
]