mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
5136 lines
146 KiB
Markdown
5136 lines
146 KiB
Markdown
<!-- NO_MARKDOWN_PARSING -->
|
|
|
|
<h1>App helpers</h1>
|
|
|
|
<p>Doc auto-generated by <a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/doc/generate_helper_doc.py">this script</a> on 03/30/2020 (Yunohost version 3.7.0.12)</p>
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">apt</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_is_installed" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_is_installed</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check either a package is installed or not</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_is_installed" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_is_installed --package=name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-p</code>, <code>--package</code> : the package name to check</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_package_is_installed --package=yunohost && echo "ok"</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L51">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_version" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_version</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Get the version of an installed package</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_version" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_version --package=name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-p</code>, <code>--package</code> : the package name to get version</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: the version or an empty string
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">version=$(ynh_package_version --package=yunohost)</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L73">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_update" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_update</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Update package index files</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_update" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_update</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L105">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_install" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_install</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Install package(s)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_install" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_install name [name [...]]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>name</code> : the package name to install</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L115">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_remove" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_remove</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove package(s)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_remove" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_remove name [name [...]]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>name</code> : the package name to remove</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L126">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_autoremove" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_autoremove</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove package(s) and their uneeded dependencies</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_autoremove" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_autoremove name [name [...]]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>name</code> : the package name to remove</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L136">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_package_autopurge" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_package_autopurge</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Purge package(s) and their uneeded dependencies</h6>
|
|
</div>
|
|
<div id="collapse-ynh_package_autopurge" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_package_autopurge name [name [...]]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>name</code> : the package name to autoremove and purge</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L146">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_install_app_dependencies" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_install_app_dependencies</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Define and install dependencies with a equivs control file</h6>
|
|
</div>
|
|
<div id="collapse-ynh_install_app_dependencies" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_install_app_dependencies dep [dep [...]]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>dep</code> : the package name to install in dependence. Writing "dep3|dep4|dep5" can be used to specify alternatives. For example : dep1 dep2 "dep3|dep4|dep5" will require to install dep1 and dep 2 and (dep3 or dep4 or dep5).</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This helper can/should only be called once per app</br></br>example : ynh_install_app_dependencies dep1 dep2 "dep3|dep4|dep5"</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L206">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_app_dependencies" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_app_dependencies</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove fake package and its dependencies</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_app_dependencies" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_app_dependencies</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Dependencies will removed only if no other package need them.</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/apt#L265">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">backup</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_backup" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_backup</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Add a file or a directory to the list of paths to backup</h6>
|
|
</div>
|
|
<div id="collapse-ynh_backup" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_backup --src_path=src_path [--dest_path=dest_path] [--is_big] [--not_mandatory]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-s</code>, <code>--src_path</code> : file or directory to bind or symlink or copy. it shouldn't be in the backup dir.</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--dest_path</code> : destination file or directory inside the backup dir</li>
|
|
|
|
|
|
|
|
<li><code>-b</code>, <code>--is_big</code> : Indicate data are big (mail, video, image ...)</li>
|
|
|
|
|
|
|
|
<li><code>-m</code>, <code>--not_mandatory</code> : Indicate that if the file is missing, the backup can ignore it.</li>
|
|
|
|
|
|
|
|
<li><code>arg</code> : Deprecated arg</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This helper can be used both in a system backup hook, and in an app backup script</br></br>Details: ynh_backup writes SRC and the relative DEST into a CSV file. And it</br>creates the parent destination directory</br></br>If DEST is ended by a slash it complete this path with the basename of SRC.</br></br>Example in the context of a wordpress app</br></br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf"</br># => This line will be added into CSV file</br># "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/etc/nginx/conf.d/$domain.d/$app.conf"</br></br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" "conf/nginx.conf"</br># => "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/conf/nginx.conf"</br></br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" "conf/"</br># => "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/conf/$app.conf"</br></br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" "conf"</br># => "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/conf"</br></br>#Deprecated usages (maintained for retro-compatibility)</br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" "${backup_dir}/conf/nginx.conf"</br># => "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/conf/nginx.conf"</br></br>ynh_backup "/etc/nginx/conf.d/$domain.d/$app.conf" "/conf/"</br># => "/etc/nginx/conf.d/$domain.d/$app.conf","apps/wordpress/conf/$app.conf"</br></br>Requires YunoHost version 2.4.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L44">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_restore" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_restore</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Restore all files that were previously backuped in a core backup script or app backup script</h6>
|
|
</div>
|
|
<div id="collapse-ynh_restore" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_restore</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L161">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_restore_file" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_restore_file</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Restore a file or a directory</h6>
|
|
</div>
|
|
<div id="collapse-ynh_restore_file" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_restore_file --origin_path=origin_path [--dest_path=dest_path] [--not_mandatory]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-o</code>, <code>--origin_path</code> : Path where was located the file or the directory before to be backuped or relative path to $YNH_CWD where it is located in the backup archive</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--dest_path</code> : Path where restore the file or the dir, if unspecified, the destination will be ORIGIN_PATH or if the ORIGIN_PATH doesn't exist in the archive, the destination will be searched into backup.csv</li>
|
|
|
|
|
|
|
|
<li><code>-m</code>, <code>--not_mandatory</code> : Indicate that if the file is missing, the restore process can ignore it.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Examples</strong>:<ul>
|
|
|
|
|
|
<code class="helper-code"> ynh_restore_file "/etc/nginx/conf.d/$domain.d/$app.conf"</code>
|
|
|
|
<br>
|
|
|
|
|
|
You can also use relative paths:
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_restore_file "conf/nginx.conf"</code>
|
|
|
|
<br>
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Use the registered path in backup_list by ynh_backup to restore the file at</br>the right place.</br></br>If DEST_PATH already exists and is lighter than 500 Mo, a backup will be made in</br>/home/yunohost.conf/backup/. Otherwise, the existing file is removed.</br></br>if apps/wordpress/etc/nginx/conf.d/$domain.d/$app.conf exists, restore it into</br>/etc/nginx/conf.d/$domain.d/$app.conf</br>if no, search for a match in the csv (eg: conf/nginx.conf) and restore it into</br>/etc/nginx/conf.d/$domain.d/$app.conf</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L220">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_store_file_checksum" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_store_file_checksum</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Calculate and store a file checksum into the app settings</h6>
|
|
</div>
|
|
<div id="collapse-ynh_store_file_checksum" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_store_file_checksum --file=file</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file</code> : The file on which the checksum will performed, then stored.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
$app should be defined when calling this helper</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L296">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_backup_if_checksum_is_different" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_backup_if_checksum_is_different</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Verify the checksum and backup the file if it's different</h6>
|
|
</div>
|
|
<div id="collapse-ynh_backup_if_checksum_is_different" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_backup_if_checksum_is_different --file=file</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file</code> : The file on which the checksum test will be perfomed.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: the name of a backup file, or nothing
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This helper is primarily meant to allow to easily backup personalised/manually</br>modified config files.</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L328">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_delete_file_checksum" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_delete_file_checksum</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Delete a file checksum from the app settings</h6>
|
|
</div>
|
|
<div id="collapse-ynh_delete_file_checksum" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_file_checksum file</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file=</code> : The file for which the checksum will be deleted</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
$app should be defined when calling this helper</br></br>Requires YunoHost version 3.3.1 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L361">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_backup_before_upgrade" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_backup_before_upgrade</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Make a backup in case of failed upgrade</h6>
|
|
</div>
|
|
<div id="collapse-ynh_backup_before_upgrade" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_backup_before_upgrade
|
|
ynh_clean_setup () {
|
|
ynh_restore_upgradebackup
|
|
}
|
|
ynh_abort_if_errors</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L383">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_restore_upgradebackup" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_restore_upgradebackup</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Restore a previous backup if the upgrade process failed</h6>
|
|
</div>
|
|
<div id="collapse-ynh_restore_upgradebackup" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_backup_before_upgrade
|
|
ynh_clean_setup () {
|
|
ynh_restore_upgradebackup
|
|
}
|
|
ynh_abort_if_errors</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/backup#L432">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">fail2ban</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_fail2ban_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_fail2ban_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a dedicated fail2ban config (jail and filter conf files)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_fail2ban_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">1: ynh_add_fail2ban_config --logpath=log_file --failregex=filter [--max_retry=max_retry] [--ports=ports]
|
|
2: ynh_add_fail2ban_config --use_template [--others_var="list of others variables to replace"]
|
|
| for example : 'var_1 var_2 ...'</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-l</code>, <code>--logpath=</code> : Log file to be checked by fail2ban</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--failregex=</code> : Failregex to be looked for by fail2ban</li>
|
|
|
|
|
|
|
|
<li><code>-m</code>, <code>--max_retry=</code> : Maximum number of retries allowed before banning IP address - default: 3</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--ports=</code> : Ports blocked for a banned IP address - default: http,https</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--use_template</code> : Use this helper in template mode</li>
|
|
|
|
|
|
|
|
<li><code>-v</code>, <code>--others_var=</code> : List of others variables to replace separeted by a space</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
-----------------------------------------------------------------------------</br></br>This will use a template in ../conf/f2b_jail.conf and ../conf/f2b_filter.conf</br> __APP__ by $app</br></br>You can dynamically replace others variables by example :</br> __VAR_1__ by $var_1</br> __VAR_2__ by $var_2</br></br>Generally your template will look like that by example (for synapse):</br></br>f2b_jail.conf:</br> [__APP__]</br> enabled = true</br> port = http,https</br> filter = __APP__</br> logpath = /var/log/__APP__/logfile.log</br> maxretry = 3</br></br>f2b_filter.conf:</br> [INCLUDES]</br> before = common.conf</br> [Definition]</br></br># Part of regex definition (just used to make more easy to make the global regex)</br> __synapse_start_line = .? \- synapse\..+ \-</br></br># Regex definition.</br> failregex = ^%(__synapse_start_line)s INFO \- POST\-(\d+)\- <HOST> \- \d+ \- Received request\: POST /_matrix/client/r0/login\??<SKIPLINES>%(__synapse_start_line)s INFO \- POST\-\1\- Got login request with identifier: \{u'type': u'm.id.user', u'user'\: u'(.+?)'\}, medium\: None, address: None, user\: u'\5'<SKIPLINES>%(__synapse_start_line)s WARNING \- \- (Attempted to login as @\5\:.+ but they do not exist|Failed password login for user @\5\:.+)$</br></br>ignoreregex =</br></br>-----------------------------------------------------------------------------</br></br>Note about the "failregex" option:</br> regex to match the password failure messages in the logfile. The</br> host must be matched by a group named "host". The tag "<HOST>" can</br> be used for standard IP/hostname matching and is only an alias for</br> (?:::f{4,6}:)?(?P<host>[\w\-.^_]+)</br></br>You can find some more explainations about how to make a regex here :</br> https://www.fail2ban.org/wiki/index.php/MANUAL_0_8#Filters</br></br>Note that the logfile need to exist before to call this helper !!</br></br>To validate your regex you can test with this command:</br>fail2ban-regex /var/log/YOUR_LOG_FILE_PATH /etc/fail2ban/filter.d/YOUR_APP.conf</br></br>Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/fail2ban#L65">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_fail2ban_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_fail2ban_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the dedicated fail2ban config (jail and filter conf files)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_fail2ban_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_fail2ban_config</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/fail2ban#L147">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">getopts</h3>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">logging</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_die" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_die</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Print a message to stderr and exit</h6>
|
|
</div>
|
|
<div id="collapse-ynh_die" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_die --message=MSG [--ret_code=RETCODE]</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.4.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L8">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_print_info" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_print_info</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Display a message in the 'INFO' logging category</h6>
|
|
</div>
|
|
<div id="collapse-ynh_print_info" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_print_info --message="Some message"</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L26">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_print_warn" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_print_warn</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Print a warning on stderr</h6>
|
|
</div>
|
|
<div id="collapse-ynh_print_warn" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_print_warn --message="Text to print"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--message</code> : The text to print</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L71">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_print_err" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_print_err</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Print an error on stderr</h6>
|
|
</div>
|
|
<div id="collapse-ynh_print_err" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_print_err --message="Text to print"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--message</code> : The text to print</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L88">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_exec_err" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_exec_err</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and print the result as an error</h6>
|
|
</div>
|
|
<div id="collapse-ynh_exec_err" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_exec_err your_command
|
|
ynh_exec_err "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L111">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_exec_warn" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_exec_warn</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and print the result as a warning</h6>
|
|
</div>
|
|
<div id="collapse-ynh_exec_warn" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_exec_warn your_command
|
|
ynh_exec_warn "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L127">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_exec_warn_less" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_exec_warn_less</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and force the result to be printed on stdout</h6>
|
|
</div>
|
|
<div id="collapse-ynh_exec_warn_less" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_exec_warn_less your_command
|
|
ynh_exec_warn_less "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L143">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_exec_quiet" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_exec_quiet</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and redirect stdout in /dev/null</h6>
|
|
</div>
|
|
<div id="collapse-ynh_exec_quiet" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_exec_quiet your_command
|
|
ynh_exec_quiet "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L159">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_exec_fully_quiet" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_exec_fully_quiet</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and redirect stdout and stderr in /dev/null</h6>
|
|
</div>
|
|
<div id="collapse-ynh_exec_fully_quiet" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_exec_fully_quiet your_command
|
|
ynh_exec_fully_quiet "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L175">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_print_OFF" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_print_OFF</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove any logs for all the following commands.</h6>
|
|
</div>
|
|
<div id="collapse-ynh_print_OFF" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_print_OFF</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
WARNING: You should be careful with this helper, and never forget to use ynh_print_ON as soon as possible to restore the logging.</br></br>Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L186">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_print_ON" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_print_ON</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Restore the logging after ynh_print_OFF</h6>
|
|
</div>
|
|
<div id="collapse-ynh_print_ON" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_print_ON</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.2.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L195">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_script_progression" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_script_progression</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Print a progress bar showing the progression of an app script</h6>
|
|
</div>
|
|
<div id="collapse-ynh_script_progression" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_script_progression --message=message [--weight=weight] [--time]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--message=</code> : The text to print</li>
|
|
|
|
|
|
|
|
<li><code>-w</code>, <code>--weight=</code> : The weight for this progression. This value is 1 by default. Use a bigger value for a longer part of the script.</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--time=</code> : Print the execution time since the last call to this helper. Especially usefull to define weights. The execution time is given for the duration since the previous call. So the weight should be applied to this previous call.</li>
|
|
|
|
|
|
|
|
<li><code>-l</code>, <code>--last=</code> : Use for the last call of the helper, to fill te progression bar.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L223">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_return" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_return</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Return data to the Yunohost core for later processing
|
|
(to be used by special hooks like app config panel and core diagnosis)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_return" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_return somedata</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.6.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L307">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_debug" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_debug</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Debugger for app packagers</h6>
|
|
</div>
|
|
<div id="collapse-ynh_debug" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_debug [--message=message] [--trace=1/0]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--message=</code> : The text to print</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--trace=</code> : Turn on or off the trace of the script. Usefull to trace nonly a small part of a script.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L318">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_debug_exec" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_debug_exec</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command and print the result as debug</h6>
|
|
</div>
|
|
<div id="collapse-ynh_debug_exec" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code helper-usage">ynh_debug_exec your_command
|
|
ynh_debug_exec "your_command | other_command"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>command</code> : command to execute</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
When using pipes, double quotes are required - otherwise, this helper will run the first command, and the whole output will be sent through the next pipe.</br></br>If the command to execute uses double quotes, they have to be escaped or they will be interpreted and removed.</br></br>Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logging#L376">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">logrotate</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_use_logrotate" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_use_logrotate</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Use logrotate to manage the logfile</h6>
|
|
</div>
|
|
<div id="collapse-ynh_use_logrotate" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_use_logrotate [--logfile=/log/file] [--nonappend] [--specific_user=user/group]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-l</code>, <code>--logfile</code> : absolute path of logfile</li>
|
|
|
|
|
|
|
|
<li><code>-n</code>, <code>--nonappend</code> : (optional) Replace the config file instead of appending this new config.</li>
|
|
|
|
|
|
|
|
<li><code>-u</code>, <code>--specific_user</code> : run logrotate as the specified user and group. If not specified logrotate is runned as root.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
If no --logfile is provided, /var/log/${app} will be used as default.</br>logfile can be just a directory, or a full path to a logfile :</br>/parentdir/logdir</br>/parentdir/logdir/logfile.log</br></br>It's possible to use this helper multiple times, each config will be added to</br>the same logrotate config file. Unless you use the option --non-append</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logrotate#L19">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_logrotate" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_logrotate</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the app's logrotate config.</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_logrotate" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_logrotate</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/logrotate#L102">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">mysql</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_connect_as" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_connect_as</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Open a connection as a user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_connect_as" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_connect_as --user=user --password=password [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--user</code> : the user name to connect as</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--password</code> : the user password</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_mysql_connect_as 'user' 'pass' <<< "UPDATE ...;" example: ynh_mysql_connect_as 'user' 'pass' < /path/to/file.sql</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L16">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_execute_as_root" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_execute_as_root</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command as root user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_execute_as_root" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_execute_as_root --sql=sql [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-s</code>, <code>--sql</code> : the SQL command to execute</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L37">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_execute_file_as_root" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_execute_file_as_root</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command from a file as root user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_execute_file_as_root" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_execute_file_as_root --file=file [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file</code> : the file containing SQL commands</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L58">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_dump_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_dump_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Dump a database</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_dump_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_dump_db --database=database</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database name to dump</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: the mysqldump output
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_mysql_dump_db 'roundcube' > ./dump.sql</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L121">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_user_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_user_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a mysql user exists</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_user_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_user_exists --user=user</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--user</code> : the user for which to check existence</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L152">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_setup_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_setup_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a database, an user and its password. Then store the password in the app's config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_setup_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_setup_db --db_user=user --db_name=name [--db_pwd=pwd]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--db_user</code> : Owner of the database</li>
|
|
|
|
|
|
|
|
<li><code>-n</code>, <code>--db_name</code> : Name of the database</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--db_pwd</code> : Password of the database. If not provided, a password will be generated</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
After executing this helper, the password of the created database will be available in $db_pwd</br>It will also be stored as "mysqlpwd" into the app settings.</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L192">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_mysql_remove_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_mysql_remove_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove a database if it exists, and the associated user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_mysql_remove_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_mysql_remove_db --db_user=user --db_name=name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--db_user</code> : Owner of the database</li>
|
|
|
|
|
|
|
|
<li><code>-n</code>, <code>--db_name</code> : Name of the database</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/mysql#L217">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">network</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_find_port" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_find_port</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Find a free port and return it</h6>
|
|
</div>
|
|
<div id="collapse-ynh_find_port" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_find_port --port=begin_port</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-p</code>, <code>--port</code> : port to start to search</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">port=$(ynh_find_port --port=8080)</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/network#L11">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_validate_ip" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_validate_ip</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Validate an IP address</h6>
|
|
</div>
|
|
<div id="collapse-ynh_validate_ip" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_validate_ip --family=family --ip_address=ip_address</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: 0 for valid ip addresses, 1 otherwise
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_validate_ip 4 111.222.333.444</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/network#L35">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_validate_ip4" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_validate_ip4</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Validate an IPv4 address</h6>
|
|
</div>
|
|
<div id="collapse-ynh_validate_ip4" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_validate_ip4 --ip_address=ip_address</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: 0 for valid ipv4 addresses, 1 otherwise
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_validate_ip4 111.222.333.444</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/network#L69">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_validate_ip6" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_validate_ip6</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Validate an IPv6 address</h6>
|
|
</div>
|
|
<div id="collapse-ynh_validate_ip6" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_validate_ip6 --ip_address=ip_address</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: 0 for valid ipv6 addresses, 1 otherwise
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_validate_ip6 2000:dead:beef::1</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/network#L90">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">nginx</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_nginx_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_nginx_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a dedicated nginx config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_nginx_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_nginx_config "list of others variables to replace"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>list</code> : (Optional) list of others variables to replace separated by spaces. For example : 'path_2 port_2 ...'</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This will use a template in ../conf/nginx.conf</br> __PATH__ by $path_url</br> __DOMAIN__ by $domain</br> __PORT__ by $port</br> __NAME__ by $app</br> __FINALPATH__ by $final_path</br></br>And dynamic variables (from the last example) :</br> __PATH_2__ by $path_2</br> __PORT_2__ by $port_2</br></br>Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/nginx#L21">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_nginx_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_nginx_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the dedicated nginx config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_nginx_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_nginx_config</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/nginx#L73">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">nodejs</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_use_nodejs" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_use_nodejs</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Load the version of node for an app, and set variables.</h6>
|
|
</div>
|
|
<div id="collapse-ynh_use_nodejs" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_use_nodejs</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
ynh_use_nodejs has to be used in any app scripts before using node for the first time.</br></br>2 variables are available:</br> - $nodejs_path: The absolute path of node for the chosen version.</br> - $nodejs_version: Just the version number of node for this app. Stored as 'nodejs_version' in settings.yml.</br>And 2 alias stored in variables:</br> - $nodejs_use_version: An old variable, not used anymore. Keep here to not break old apps</br> NB: $PATH will contain the path to node, it has to be propagated to any other shell which needs to use it.</br> That's means it has to be added to any systemd script.</br></br>Requires YunoHost version 2.7.12 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/nodejs#L43">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_install_nodejs" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_install_nodejs</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Install a specific version of nodejs</h6>
|
|
</div>
|
|
<div id="collapse-ynh_install_nodejs" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_install_nodejs --nodejs_version=nodejs_version</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-n</code>, <code>--nodejs_version</code> : Version of node to install. When possible, your should prefer to use major version number (e.g. 8 instead of 8.10.0). The crontab will then handle the update of minor versions when needed.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
n (Node version management) uses the PATH variable to store the path of the version of node it is going to use.</br>That's how it changes the version</br></br>ynh_install_nodejs will install the version of node provided as argument by using n.</br></br>Requires YunoHost version 2.7.12 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/nodejs#L66">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_nodejs" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_nodejs</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the version of node used by the app.</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_nodejs" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_nodejs</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This helper will check if another app uses the same version of node,</br>if not, this version of node will be removed.</br>If no other app uses node, n will be also removed.</br></br>Requires YunoHost version 2.7.12 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/nodejs#L144">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">php</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_fpm_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_fpm_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a dedicated php-fpm config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_fpm_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_fpm_config [--phpversion=7.X]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-v</code>, <code>--phpversion</code> : Version of php to use.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/php#L9">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_fpm_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_fpm_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the dedicated php-fpm config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_fpm_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_fpm_config</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/php#L56">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">postgresql</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_connect_as" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_connect_as</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Open a connection as a user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_connect_as" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_connect_as --user=user --password=password [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--user</code> : the user name to connect as</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--password</code> : the user password</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Examples</strong>:<ul>
|
|
|
|
|
|
<code class="helper-code"> ynh_psql_connect_as 'user' 'pass' <<< "UPDATE ...;"</code>
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_psql_connect_as 'user' 'pass' < /path/to/file.sql</code>
|
|
|
|
<br>
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L17">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_execute_as_root" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_execute_as_root</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command as root user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_execute_as_root" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_execute_as_root --sql=sql [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-s</code>, <code>--sql</code> : the SQL command to execute</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L38">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_execute_file_as_root" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_execute_file_as_root</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Execute a command from a file as root user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_execute_file_as_root" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_execute_file_as_root --file=file [--database=database]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file</code> : the file containing SQL commands</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database to connect to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L59">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_dump_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_dump_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Dump a database</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_dump_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_dump_db --database=database</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database name to dump</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: the psqldump output
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_psql_dump_db 'roundcube' > ./dump.sql</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L125">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_user_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_user_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a psql user exists</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_user_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_user_exists --user=user</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--user</code> : the user for which to check existence</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L155">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_database_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_database_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a psql database exists</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_database_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_database_exists --database=database</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-d</code>, <code>--database</code> : the database for which to check existence</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L174">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_setup_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_setup_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a database, an user and its password. Then store the password in the app's config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_setup_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_setup_db --db_user=user --db_name=name [--db_pwd=pwd]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--db_user</code> : Owner of the database</li>
|
|
|
|
|
|
|
|
<li><code>-n</code>, <code>--db_name</code> : Name of the database</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--db_pwd</code> : Password of the database. If not given, a password will be generated</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
After executing this helper, the password of the created database will be available in $db_pwd</br>It will also be stored as "psqlpwd" into the app settings.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L210">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_remove_db" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_remove_db</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove a database if it exists, and the associated user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_remove_db" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_remove_db --db_user=user --db_name=name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--db_user</code> : Owner of the database</li>
|
|
|
|
|
|
|
|
<li><code>-n</code>, <code>--db_name</code> : Name of the database</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L237">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_psql_test_if_first_run" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_psql_test_if_first_run</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a master password and set up global settings
|
|
Please always call this script in install and restore scripts</h6>
|
|
</div>
|
|
<div id="collapse-ynh_psql_test_if_first_run" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_psql_test_if_first_run</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/postgresql#L265">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">setting</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_app_setting_get" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_app_setting_get</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Get an application setting</h6>
|
|
</div>
|
|
<div id="collapse-ynh_app_setting_get" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_app_setting_get --app=app --key=key</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--app</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-k</code>, <code>--key</code> : the setting to get</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L10">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_app_setting_set" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_app_setting_set</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Set an application setting</h6>
|
|
</div>
|
|
<div id="collapse-ynh_app_setting_set" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_app_setting_set --app=app --key=key --value=value</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--app</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-k</code>, <code>--key</code> : the setting name to set</li>
|
|
|
|
|
|
|
|
<li><code>-v</code>, <code>--value</code> : the setting value to set</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L30">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_app_setting_delete" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_app_setting_delete</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Delete an application setting</h6>
|
|
</div>
|
|
<div id="collapse-ynh_app_setting_delete" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_app_setting_delete --app=app --key=key</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--app</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-k</code>, <code>--key</code> : the setting to delete</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L50">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_skipped_uris" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_skipped_uris</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Add skipped_uris urls into the config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_skipped_uris" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_skipped_uris [--appid=app] --url=url1,url2 [--regex]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--appid</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-u</code>, <code>--url</code> : the urls to add to the sso for this app</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--regex</code> : Use the key 'skipped_regex' instead of 'skipped_uris'</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
An URL set with 'skipped_uris' key will be totally ignored by the SSO,</br>which means that the access will be public and the logged-in user information will not be passed to the app.</br></br>Requires YunoHost version 3.6.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L73">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_unprotected_uris" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_unprotected_uris</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Add unprotected_uris urls into the config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_unprotected_uris" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_unprotected_uris [--appid=app] --url=url1,url2 [--regex]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--appid</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-u</code>, <code>--url</code> : the urls to add to the sso for this app</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--regex</code> : Use the key 'unprotected_regex' instead of 'unprotected_uris'</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
An URL set with unprotected_uris key will be accessible publicly, but if an user is logged in,</br>his information will be accessible (through HTTP headers) to the app.</br></br>Requires YunoHost version 3.6.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L104">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_protected_uris" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_protected_uris</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Add protected_uris urls into the config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_protected_uris" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_protected_uris [--appid=app] --url=url1,url2 [--regex]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--appid</code> : the application id</li>
|
|
|
|
|
|
|
|
<li><code>-u</code>, <code>--url</code> : the urls to add to the sso for this app</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--regex</code> : Use the key 'protected_regex' instead of 'protected_uris'</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
An URL set with protected_uris will be blocked by the SSO and accessible only to authenticated and authorized users.</br></br>Requires YunoHost version 3.6.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L134">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_webpath_available" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_webpath_available</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check availability of a web path</h6>
|
|
</div>
|
|
<div id="collapse-ynh_webpath_available" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_webpath_available --domain=domain --path_url=path</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-d</code>, <code>--domain</code> : the domain/host of the url</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--path_url</code> : the web path to check the availability of</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_webpath_available --domain=some.domain.tld --path_url=/coffee</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L216">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_webpath_register" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_webpath_register</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Register/book a web path for an app</h6>
|
|
</div>
|
|
<div id="collapse-ynh_webpath_register" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_webpath_register --app=app --domain=domain --path_url=path</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-a</code>, <code>--app</code> : the app for which the domain should be registered</li>
|
|
|
|
|
|
|
|
<li><code>-d</code>, <code>--domain</code> : the domain/host of the web path</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--path_url</code> : the web path to be registered</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_webpath_register --app=wordpress --domain=some.domain.tld --path_url=/coffee</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L238">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_permission_create" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_permission_create</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a new permission for the app</h6>
|
|
</div>
|
|
<div id="collapse-ynh_permission_create" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_permission_create --permission "permission" [--url "url"] [--allowed group1 group2]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>permission</code> : the name for the permission (by default a permission named "main" already exist)</li>
|
|
|
|
|
|
|
|
<li><code>url</code> : (optional) URL for which access will be allowed/forbidden</li>
|
|
|
|
|
|
|
|
<li><code>allowed</code> : (optional) A list of group/user to allow for the permission</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_permission_create --permission admin --url /admin --allowed alice bob</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
If provided, 'url' is assumed to be relative to the app domain/path if they</br>start with '/'. For example:</br> / -> domain.tld/app</br> /admin -> domain.tld/app/admin</br> domain.tld/app/api -> domain.tld/app/api</br></br>'url' can be later treated as a regex if it starts with "re:".</br>For example:</br> re:/api/[A-Z]*$ -> domain.tld/app/api/[A-Z]*$</br> re:domain.tld/app/api/[A-Z]*$ -> domain.tld/app/api/[A-Z]*$</br></br>Requires YunoHost version 3.7.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L272">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_permission_delete" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_permission_delete</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove a permission for the app (note that when the app is removed all permission is automatically removed)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_permission_delete" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_permission_delete --permission "permission"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>permission</code> : the name for the permission (by default a permission named "main" is removed automatically when the app is removed)</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_permission_delete --permission editors</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.7.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L300">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_permission_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_permission_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a permission exists</h6>
|
|
</div>
|
|
<div id="collapse-ynh_permission_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_permission_exists --permission=permission</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-p</code>, <code>--permission</code> : the permission to check</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.7.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L314">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_permission_url" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_permission_url</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Redefine the url associated to a permission</h6>
|
|
</div>
|
|
<div id="collapse-ynh_permission_url" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_permission_url --permission "permission" --url "url"</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>permission</code> : the name for the permission (by default a permission named "main" is removed automatically when the app is removed)</li>
|
|
|
|
|
|
|
|
<li><code>url</code> : (optional) URL for which access will be allowed/forbidden</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.7.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L329">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_permission_update" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_permission_update</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Update a permission for the app</h6>
|
|
</div>
|
|
<div id="collapse-ynh_permission_update" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_permission_update --permission "permission" --add "group" ["group" ...] --remove "group" ["group" ...]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>permission</code> : the name for the permission (by default a permission named "main" already exist)</li>
|
|
|
|
|
|
|
|
<li><code>add</code> : the list of group or users to enable add to the permission</li>
|
|
|
|
|
|
|
|
<li><code>remove</code> : the list of group or users to remove from the permission</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_permission_update --permission admin --add samdoe --remove all_users Requires YunoHost version 3.7.0 or higher.</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/setting#L354">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">string</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_string_random" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_string_random</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Generate a random string</h6>
|
|
</div>
|
|
<div id="collapse-ynh_string_random" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_string_random [--length=string_length]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-l</code>, <code>--length</code> : the string length to generate (default: 24)</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">pwd=$(ynh_string_random --length=8)</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/string#L11">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_replace_string" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_replace_string</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Substitute/replace a string (or expression) by another in a file</h6>
|
|
</div>
|
|
<div id="collapse-ynh_replace_string" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_replace_string --match_string=match_string --replace_string=replace_string --target_file=target_file</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--match_string</code> : String to be searched and replaced in the file</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--replace_string</code> : String that will replace matches</li>
|
|
|
|
|
|
|
|
<li><code>-f</code>, <code>--target_file</code> : File in which the string will be replaced.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
As this helper is based on sed command, regular expressions and</br>references to sub-expressions can be used</br>(see sed manual page for more information)</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/string#L37">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_replace_special_string" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_replace_special_string</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Substitute/replace a special string by another in a file</h6>
|
|
</div>
|
|
<div id="collapse-ynh_replace_special_string" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_replace_special_string --match_string=match_string --replace_string=replace_string --target_file=target_file</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--match_string</code> : String to be searched and replaced in the file</li>
|
|
|
|
|
|
|
|
<li><code>-r</code>, <code>--replace_string</code> : String that will replace matches</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--target_file</code> : File in which the string will be replaced.</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This helper will use ynh_replace_string, but as you can use special</br>characters, you can't use some regular expressions and sub-expressions.</br></br>Requires YunoHost version 2.7.7 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/string#L66">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_sanitize_dbid" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_sanitize_dbid</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Sanitize a string intended to be the name of a database
|
|
(More specifically : replace - and . by _)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_sanitize_dbid" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_sanitize_dbid --db_name=name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-n</code>, <code>--db_name</code> : name to correct/sanitize</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: the corrected name
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">dbname=$(ynh_sanitize_dbid $app)</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/string#L97">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_normalize_url_path" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_normalize_url_path</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Normalize the url path syntax</h6>
|
|
</div>
|
|
<div id="collapse-ynh_normalize_url_path" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_normalize_url_path --path_url=path_to_normalize</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-p</code>, <code>--path_url</code> : URL path to normalize before using it</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Examples</strong>:<ul>
|
|
|
|
|
|
<code class="helper-code"> url_path=$(ynh_normalize_url_path $url_path)</code>
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_normalize_url_path example # -> /example</code>
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_normalize_url_path /example # -> /example</code>
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_normalize_url_path /example/ # -> /example</code>
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_normalize_url_path / # -> /</code>
|
|
|
|
<br>
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Handle the slash at the beginning of path and its absence at ending</br>Return a normalized url path</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/string#L125">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">systemd</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_add_systemd_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_add_systemd_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a dedicated systemd config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_add_systemd_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_add_systemd_config [--service=service] [--template=template]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-s</code>, <code>--service</code> : Service name (optionnal, $app by default)</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--template</code> : Name of template file (optionnal, this is 'systemd' by default, meaning ./conf/systemd.service will be used as template)</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This will use the template ../conf/<templatename>.service</br>to generate a systemd config, by replacing the following keywords</br>with global variables that should be defined before calling</br>this helper :</br></br>__APP__ by $app</br> __FINALPATH__ by $final_path</br></br>Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/systemd#L18">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_remove_systemd_config" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_remove_systemd_config</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove the dedicated systemd config</h6>
|
|
</div>
|
|
<div id="collapse-ynh_remove_systemd_config" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_remove_systemd_config [--service=service]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-s</code>, <code>--service</code> : Service name (optionnal, $app by default)</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.2 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/systemd#L54">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_systemd_action" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_systemd_action</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Start (or other actions) a service, print a log in case of failure and optionnaly wait until the service is completely started</h6>
|
|
</div>
|
|
<div id="collapse-ynh_systemd_action" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_systemd_action [-n service_name] [-a action] [ [-l "line to match"] [-p log_path] [-t timeout] [-e length] ]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-n</code>, <code>--service_name=</code> : Name of the service to start. Default : $app</li>
|
|
|
|
|
|
|
|
<li><code>-a</code>, <code>--action=</code> : Action to perform with systemctl. Default: start</li>
|
|
|
|
|
|
|
|
<li><code>-l</code>, <code>--line_match=</code> : Line to match - The line to find in the log to attest the service have finished to boot. If not defined it don't wait until the service is completely started. WARNING: When using --line_match, you should always add `ynh_clean_check_starting` into your `ynh_clean_setup` at the beginning of the script. Otherwise, tail will not stop in case of failure of the script. The script will then hang forever.</li>
|
|
|
|
|
|
|
|
<li><code>-p</code>, <code>--log_path=</code> : Log file - Path to the log file. Default : /var/log/$app/$app.log</li>
|
|
|
|
|
|
|
|
<li><code>-t</code>, <code>--timeout=</code> : Timeout - The maximum time to wait before ending the watching. Default : 300 seconds.</li>
|
|
|
|
|
|
|
|
<li><code>-e</code>, <code>--length=</code> : Length of the error log : Default : 20</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/systemd#L81">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_clean_check_starting" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_clean_check_starting</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Clean temporary process and file used by ynh_check_starting
|
|
(usually used in ynh_clean_setup scripts)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_clean_check_starting" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_clean_check_starting</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/systemd#L167">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">user</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_user_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_user_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a YunoHost user exists</h6>
|
|
</div>
|
|
<div id="collapse-ynh_user_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_user_exists --username=username</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--username</code> : the username to check</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_user_exists 'toto' || exit 1</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L11">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_user_get_info" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_user_get_info</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Retrieve a YunoHost user information</h6>
|
|
</div>
|
|
<div id="collapse-ynh_user_get_info" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_user_get_info --username=username --key=key</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--username</code> : the username to retrieve info from</li>
|
|
|
|
|
|
|
|
<li><code>-k</code>, <code>--key</code> : the key to retrieve</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: string - the key's value
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">mail=$(ynh_user_get_info 'toto' 'mail')</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L32">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_user_list" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_user_list</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Get the list of YunoHost users</h6>
|
|
</div>
|
|
<div id="collapse-ynh_user_list" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_user_list</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: string - one username per line
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">for u in $(ynh_user_list); do ...</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.4.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L52">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_system_user_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_system_user_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a user exists on the system</h6>
|
|
</div>
|
|
<div id="collapse-ynh_system_user_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_system_user_exists --username=username</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--username</code> : the username to check</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L63">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_system_group_exists" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_system_group_exists</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Check if a group exists on the system</h6>
|
|
</div>
|
|
<div id="collapse-ynh_system_group_exists" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_system_group_exists --group=group</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-g</code>, <code>--group</code> : the group to check</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L78">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_system_user_create" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_system_user_create</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Create a system user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_system_user_create" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_system_user_create --username=user_name [--home_dir=home_dir] [--use_shell]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--username</code> : Name of the system user that will be create</li>
|
|
|
|
|
|
|
|
<li><code>-h</code>, <code>--home_dir</code> : Path of the home dir for the user. Usually the final path of the app. If this argument is omitted, the user will be created without home</li>
|
|
|
|
|
|
|
|
<li><code>-s</code>, <code>--use_shell</code> : Create a user using the default login shell if present. If this argument is omitted, the user will be created with /usr/sbin/nologin shell</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Examples</strong>:<ul>
|
|
|
|
|
|
Create a nextcloud user with no home directory and /usr/sbin/nologin login shell (hence no login capability)
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_system_user_create --username=nextcloud</code>
|
|
|
|
<br>
|
|
|
|
|
|
Create a discourse user using /var/www/discourse as home directory and the default login shell
|
|
|
|
<br>
|
|
|
|
|
|
<code class="helper-code"> ynh_system_user_create --username=discourse --home_dir=/var/www/discourse --use_shell</code>
|
|
|
|
<br>
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L103">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_system_user_delete" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_system_user_delete</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Delete a system user</h6>
|
|
</div>
|
|
<div id="collapse-ynh_system_user_delete" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_system_user_delete --username=user_name</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-u</code>, <code>--username</code> : Name of the system user that will be create</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/user#L137">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<h3 style="text-transform: uppercase; font-weight: bold">utils</h3>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_abort_if_errors" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_abort_if_errors</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Exits if an error occurs during the execution of the script.</h6>
|
|
</div>
|
|
<div id="collapse-ynh_abort_if_errors" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_abort_if_errors</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
This configure the rest of the script execution such that, if an error occurs</br>or if an empty variable is used, the execution of the script stops</br>immediately and a call to `ynh_clean_setup` is triggered if it has been</br>defined by your script.</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L48">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_setup_source" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_setup_source</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Download, check integrity, uncompress and patch the source from app.src</h6>
|
|
</div>
|
|
<div id="collapse-ynh_setup_source" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_setup_source --dest_dir=dest_dir [--source_id=source_id]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-d</code>, <code>--dest_dir</code> : Directory where to setup sources</li>
|
|
|
|
|
|
|
|
<li><code>-s</code>, <code>--source_id</code> : Name of the app, if the package contains more than one app</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
The file conf/app.src need to contains:</br></br>SOURCE_URL=Address to download the app archive</br>SOURCE_SUM=Control sum</br># (Optional) Program to check the integrity (sha256sum, md5sum...)</br># default: sha256</br>SOURCE_SUM_PRG=sha256</br># (Optional) Archive format</br># default: tar.gz</br>SOURCE_FORMAT=tar.gz</br># (Optional) Put false if sources are directly in the archive root</br># default: true</br># Instead of true, SOURCE_IN_SUBDIR could be the number of sub directories</br># to remove.</br>SOURCE_IN_SUBDIR=false</br># (Optionnal) Name of the local archive (offline setup support)</br># default: ${src_id}.${src_format}</br>SOURCE_FILENAME=example.tar.gz</br># (Optional) If it set as false don't extract the source.</br># (Useful to get a debian package or a python wheel.)</br># default: true</br>SOURCE_EXTRACT=(true|false)</br></br>Details:</br>This helper downloads sources from SOURCE_URL if there is no local source</br>archive in /opt/yunohost-apps-src/APP_ID/SOURCE_FILENAME</br></br>Next, it checks the integrity with "SOURCE_SUM_PRG -c --status" command.</br></br>If it's ok, the source archive will be uncompressed in $dest_dir. If the</br>SOURCE_IN_SUBDIR is true, the first level directory of the archive will be</br>removed.</br>If SOURCE_IN_SUBDIR is a numeric value, 2 for example, the 2 first level</br>directories will be removed</br></br>Finally, patches named sources/patches/${src_id}-*.patch and extra files in</br>sources/extra_files/$src_id will be applied to dest_dir</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L99">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_local_curl" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_local_curl</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Curl abstraction to help with POST requests to local pages (such as installation forms)</h6>
|
|
</div>
|
|
<div id="collapse-ynh_local_curl" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_local_curl "page_uri" "key1=value1" "key2=value2" ...</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>page_uri</code> : Path (relative to $path_url) of the page where POST data will be sent</li>
|
|
|
|
|
|
|
|
<li><code>key1=value1</code> : (Optionnal) POST key and corresponding value</li>
|
|
|
|
|
|
|
|
<li><code>key2=value2</code> : (Optionnal) Another POST key and corresponding value</li>
|
|
|
|
|
|
|
|
<li><code>...</code> : (Optionnal) More POST keys and values</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">ynh_local_curl "/install.php?installButton" "foo=$var1" "bar=$var2"</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
$domain and $path_url should be defined externally (and correspond to the domain.tld and the /path (of the app?))</br></br>Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L213">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_render_template" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_render_template</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Render templates with Jinja2</h6>
|
|
</div>
|
|
<div id="collapse-ynh_render_template" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_render_template some_template output_path</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>some_template</code> : Template file to be rendered</li>
|
|
|
|
|
|
|
|
<li><code>output_path</code> : The path where the output will be redirected to</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Attention : Variables should be exported before calling this helper to be</br>accessible inside templates.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L252">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_get_debian_release" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_get_debian_release</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Fetch the Debian release codename</h6>
|
|
</div>
|
|
<div id="collapse-ynh_get_debian_release" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_get_debian_release</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: The Debian release codename (i.e. jessie, stretch, ...)
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.7.12 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L268">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_secure_remove" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_secure_remove</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Remove a file or a directory securely</h6>
|
|
</div>
|
|
<div id="collapse-ynh_secure_remove" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_secure_remove --file=path_to_remove</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-f</code>, <code>--file</code> : File or directory to remove</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.6.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L298">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_get_plain_key" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_get_plain_key</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Extract a key from a plain command output</h6>
|
|
</div>
|
|
<div id="collapse-ynh_get_plain_key" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_get_plain_key key [subkey [subsubkey ...]]</code>
|
|
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Returns</strong>: string - the key's value
|
|
</p>
|
|
|
|
|
|
<p>
|
|
<strong>Example</strong>: <code class="helper-code">yunohost user info tata --output-as plain | ynh_get_plain_key mail</code>
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 2.2.4 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L342">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_read_manifest" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_read_manifest</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Read the value of a key in a ynh manifest file</h6>
|
|
</div>
|
|
<div id="collapse-ynh_read_manifest" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_read_manifest manifest key</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--manifest=</code> : Path of the manifest to read</li>
|
|
|
|
|
|
|
|
<li><code>-k</code>, <code>--key=</code> : Name of the key to find</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L372">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_app_upstream_version" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_app_upstream_version</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Read the upstream version from the manifest</h6>
|
|
</div>
|
|
<div id="collapse-ynh_app_upstream_version" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_app_upstream_version [-m manifest]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--manifest=</code> : Path of the manifest to read</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
The version number in the manifest is defined by <upstreamversion>~ynh<packageversion></br>For example : 4.3-2~ynh3</br>This include the number before ~ynh</br>In the last example it return 4.3-2</br></br>Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L400">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_app_package_version" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_app_package_version</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Read package version from the manifest</h6>
|
|
</div>
|
|
<div id="collapse-ynh_app_package_version" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_app_package_version [-m manifest]</code>
|
|
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Arguments</strong>:
|
|
<ul>
|
|
|
|
|
|
<li><code>-m</code>, <code>--manifest=</code> : Path of the manifest to read</li>
|
|
|
|
|
|
</ul>
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
The version number in the manifest is defined by <upstreamversion>~ynh<packageversion></br>For example : 4.3-2~ynh3</br>This include the number after ~ynh</br>In the last example it return 3</br></br>Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L424">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div class="helper-card">
|
|
<div class="helper-card-body">
|
|
<div data-toggle="collapse" href="#collapse-ynh_check_app_version_changed" style="cursor:pointer">
|
|
<h5 class="helper-card-title"><tt>ynh_check_app_version_changed</tt></h5>
|
|
<h6 class="helper-card-subtitle text-muted">Checks the app version to upgrade with the existing app version and returns:</h6>
|
|
</div>
|
|
<div id="collapse-ynh_check_app_version_changed" class="collapse" role="tabpanel">
|
|
<hr style="margin-top:25px; margin-bottom:25px;">
|
|
<p>
|
|
|
|
<strong>Usage</strong>: <code class="helper-code">ynh_check_app_version_changed</code>
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
<strong>Details</strong>:
|
|
<p>
|
|
- UPGRADE_APP if the upstream app version has changed</br>- UPGRADE_PACKAGE if only the YunoHost package has changed</br></br>It stops the current script without error if the package is up-to-date</br></br>This helper should be used to avoid an upgrade of an app, or the upstream part</br>of it, when it's not needed</br></br>To force an upgrade, even if the package is up to date,</br>you have to set the variable YNH_FORCE_UPGRADE before.</br>example: sudo YNH_FORCE_UPGRADE=1 yunohost app upgrade MyApp</br></br>Requires YunoHost version 3.5.0 or higher.</br></br>
|
|
</p>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/helpers.d/utils#L454">Dude, show me the code !</a>
|
|
</p>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<style>
|
|
/*=================================================
|
|
Helper card
|
|
=================================================*/
|
|
.helper-card {
|
|
width:100%;
|
|
min-height: 1px;
|
|
margin-right: 10px;
|
|
margin-left: 10px;
|
|
border: 1px solid rgba(0,0,0,.125);
|
|
border-radius: 0.5rem;
|
|
word-wrap: break-word;
|
|
margin-top: 0.5rem;
|
|
margin-bottom: 0.5rem;
|
|
}
|
|
.helper-card-body {
|
|
padding: 1.25rem;
|
|
padding-top: 0.8rem;
|
|
padding-bottom: 0;
|
|
}
|
|
.helper-code {
|
|
word-wrap: break-word;
|
|
white-space: normal;
|
|
}
|
|
/*===============================================*/
|
|
|
|
</style>
|