From 71ef181659c680662fbbbc7214aa211ee3a75a7c Mon Sep 17 00:00:00 2001 From: Geoffroy Desvernay Date: Fri, 29 Nov 2024 18:27:52 +0100 Subject: [PATCH] deploy docs to github pages fix #35 --- CONTRIBUTING.md | 2 +- PULL_REQUEST_TEMPLATE.md | 2 +- README.md | 4 +- doc/.gitignore | 1 + doc/Makefile | 2 + doc/build/doctrees/advanced-use.doctree | Bin 55938 -> 0 bytes doc/build/doctrees/basic-use.doctree | Bin 59006 -> 0 bytes doc/build/doctrees/best-practices.doctree | Bin 14753 -> 0 bytes doc/build/doctrees/debian.doctree | Bin 12984 -> 0 bytes doc/build/doctrees/environment.pickle | Bin 264086 -> 0 bytes doc/build/doctrees/faq.doctree | Bin 19002 -> 0 bytes doc/build/doctrees/index.doctree | Bin 9005 -> 0 bytes doc/build/doctrees/jailtypes.doctree | Bin 19357 -> 0 bytes doc/build/doctrees/known-issues.doctree | Bin 19247 -> 0 bytes doc/build/doctrees/networking.doctree | Bin 41189 -> 0 bytes doc/build/doctrees/templates.doctree | Bin 18670 -> 0 bytes {doc/build/html => docs}/.buildinfo | 0 docs/_sources/advanced-use.rst.txt | 312 + docs/_sources/basic-use.rst.txt | 327 + docs/_sources/best-practices.rst.txt | 67 + docs/_sources/debian.rst.txt | 75 + docs/_sources/faq.rst.txt | 66 + docs/_sources/fastentrypoints.rst.txt | 7 + docs/_sources/index.rst.txt | 54 + docs/_sources/install.rst.txt | 201 + docs/_sources/iocage_cli.rst.txt | 246 + docs/_sources/iocage_lib.rst.txt | 158 + docs/_sources/jailtypes.rst.txt | 105 + docs/_sources/known-issues.rst.txt | 97 + docs/_sources/modules.rst.txt | 11 + docs/_sources/networking.rst.txt | 254 + docs/_sources/plugins.rst.txt | 126 + docs/_sources/setup.rst.txt | 7 + docs/_sources/templates.rst.txt | 91 + docs/_sources/tests.rst.txt | 30 + .../_sphinx_javascript_frameworks_compat.js | 134 + docs/_static/agogo.css | 549 + .../html => docs}/_static/ajax-loader.gif | Bin {doc/build/html => docs}/_static/basic.css | 0 docs/_static/bgfooter.png | Bin 0 -> 276 bytes docs/_static/bgtop.png | Bin 0 -> 266 bytes .../html => docs}/_static/comment-bright.png | Bin .../html => docs}/_static/comment-close.png | Bin {doc/build/html => docs}/_static/comment.png | Bin {doc/build/html => docs}/_static/doctools.js | 0 docs/_static/documentation_options.js | 14 + .../html => docs}/_static/down-pressed.png | Bin {doc/build/html => docs}/_static/down.png | Bin {doc/build/html => docs}/_static/file.png | Bin docs/_static/jquery-3.6.0.js | 10881 ++++++++++++++++ {doc/build/html => docs}/_static/jquery.js | 0 docs/_static/language_data.js | 199 + {doc/build/html => docs}/_static/minus.png | Bin {doc/build/html => docs}/_static/plus.png | Bin {doc/build/html => docs}/_static/pygments.css | 0 .../html => docs}/_static/searchtools.js | 0 docs/_static/sphinx_highlight.js | 144 + docs/_static/underscore-1.13.1.js | 2042 +++ .../html => docs}/_static/underscore-1.3.1.js | 0 .../build/html => docs}/_static/underscore.js | 0 .../html => docs}/_static/up-pressed.png | Bin {doc/build/html => docs}/_static/up.png | Bin .../build/html => docs}/_static/websupport.js | 0 {doc/build/html => docs}/advanced-use.html | 0 {doc/build/html => docs}/basic-use.html | 0 {doc/build/html => docs}/best-practices.html | 0 {doc/build/html => docs}/debian.html | 0 {doc/build/html => docs}/faq.html | 0 docs/fastentrypoints.html | 127 + {doc/build/html => docs}/genindex.html | 0 {doc/build/html => docs}/index.html | 0 docs/install.html | 279 + docs/iocage_cli.html | 305 + docs/iocage_lib.html | 1634 +++ {doc/build/html => docs}/jailtypes.html | 0 {doc/build/html => docs}/known-issues.html | 0 docs/modules.html | 513 + {doc/build/html => docs}/networking.html | 0 {doc/build/html => docs}/objects.inv | Bin docs/plugins.html | 209 + docs/py-modindex.html | 373 + {doc/build/html => docs}/search.html | 0 {doc/build/html => docs}/searchindex.js | 2 +- docs/setup.html | 106 + {doc/build/html => docs}/templates.html | 0 docs/tests.html | 118 + 86 files changed, 19868 insertions(+), 6 deletions(-) create mode 100644 doc/.gitignore delete mode 100644 doc/build/doctrees/advanced-use.doctree delete mode 100644 doc/build/doctrees/basic-use.doctree delete mode 100644 doc/build/doctrees/best-practices.doctree delete mode 100644 doc/build/doctrees/debian.doctree delete mode 100644 doc/build/doctrees/environment.pickle delete mode 100644 doc/build/doctrees/faq.doctree delete mode 100644 doc/build/doctrees/index.doctree delete mode 100644 doc/build/doctrees/jailtypes.doctree delete mode 100644 doc/build/doctrees/known-issues.doctree delete mode 100644 doc/build/doctrees/networking.doctree delete mode 100644 doc/build/doctrees/templates.doctree rename {doc/build/html => docs}/.buildinfo (100%) create mode 100644 docs/_sources/advanced-use.rst.txt create mode 100644 docs/_sources/basic-use.rst.txt create mode 100644 docs/_sources/best-practices.rst.txt create mode 100644 docs/_sources/debian.rst.txt create mode 100644 docs/_sources/faq.rst.txt create mode 100644 docs/_sources/fastentrypoints.rst.txt create mode 100644 docs/_sources/index.rst.txt create mode 100644 docs/_sources/install.rst.txt create mode 100644 docs/_sources/iocage_cli.rst.txt create mode 100644 docs/_sources/iocage_lib.rst.txt create mode 100644 docs/_sources/jailtypes.rst.txt create mode 100644 docs/_sources/known-issues.rst.txt create mode 100644 docs/_sources/modules.rst.txt create mode 100644 docs/_sources/networking.rst.txt create mode 100644 docs/_sources/plugins.rst.txt create mode 100644 docs/_sources/setup.rst.txt create mode 100644 docs/_sources/templates.rst.txt create mode 100644 docs/_sources/tests.rst.txt create mode 100644 docs/_static/_sphinx_javascript_frameworks_compat.js create mode 100644 docs/_static/agogo.css rename {doc/build/html => docs}/_static/ajax-loader.gif (100%) rename {doc/build/html => docs}/_static/basic.css (100%) create mode 100644 docs/_static/bgfooter.png create mode 100644 docs/_static/bgtop.png rename {doc/build/html => docs}/_static/comment-bright.png (100%) rename {doc/build/html => docs}/_static/comment-close.png (100%) rename {doc/build/html => docs}/_static/comment.png (100%) rename {doc/build/html => docs}/_static/doctools.js (100%) create mode 100644 docs/_static/documentation_options.js rename {doc/build/html => docs}/_static/down-pressed.png (100%) rename {doc/build/html => docs}/_static/down.png (100%) rename {doc/build/html => docs}/_static/file.png (100%) create mode 100644 docs/_static/jquery-3.6.0.js rename {doc/build/html => docs}/_static/jquery.js (100%) create mode 100644 docs/_static/language_data.js rename {doc/build/html => docs}/_static/minus.png (100%) rename {doc/build/html => docs}/_static/plus.png (100%) rename {doc/build/html => docs}/_static/pygments.css (100%) rename {doc/build/html => docs}/_static/searchtools.js (100%) create mode 100644 docs/_static/sphinx_highlight.js create mode 100644 docs/_static/underscore-1.13.1.js rename {doc/build/html => docs}/_static/underscore-1.3.1.js (100%) rename {doc/build/html => docs}/_static/underscore.js (100%) rename {doc/build/html => docs}/_static/up-pressed.png (100%) rename {doc/build/html => docs}/_static/up.png (100%) rename {doc/build/html => docs}/_static/websupport.js (100%) rename {doc/build/html => docs}/advanced-use.html (100%) rename {doc/build/html => docs}/basic-use.html (100%) rename {doc/build/html => docs}/best-practices.html (100%) rename {doc/build/html => docs}/debian.html (100%) rename {doc/build/html => docs}/faq.html (100%) create mode 100644 docs/fastentrypoints.html rename {doc/build/html => docs}/genindex.html (100%) rename {doc/build/html => docs}/index.html (100%) create mode 100644 docs/install.html create mode 100644 docs/iocage_cli.html create mode 100644 docs/iocage_lib.html rename {doc/build/html => docs}/jailtypes.html (100%) rename {doc/build/html => docs}/known-issues.html (100%) create mode 100644 docs/modules.html rename {doc/build/html => docs}/networking.html (100%) rename {doc/build/html => docs}/objects.inv (100%) create mode 100644 docs/plugins.html create mode 100644 docs/py-modindex.html rename {doc/build/html => docs}/search.html (100%) rename {doc/build/html => docs}/searchindex.js (60%) create mode 100644 docs/setup.html rename {doc/build/html => docs}/templates.html (100%) create mode 100644 docs/tests.html diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 871d0852..4ca5c1d6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -73,4 +73,4 @@ x = max( ## Documentation for Read The Docs -If you wish to update some of our [documentation](http://iocage.readthedocs.org), you only need to submit a PR for the files you change in iocage/doc/source. They will automatically be updated when the changes are merged. +If you wish to update some of our [documentation](https://freebsd.github.io/iocage/), you only need to submit a PR for the files you change in iocage/doc/source. They will automatically be updated when the changes are merged. diff --git a/PULL_REQUEST_TEMPLATE.md b/PULL_REQUEST_TEMPLATE.md index e1b58628..98b9b0b8 100644 --- a/PULL_REQUEST_TEMPLATE.md +++ b/PULL_REQUEST_TEMPLATE.md @@ -1,4 +1,4 @@ Make sure to follow and check these boxes before submitting a PR! Thank you. - [ ] Explain the feature -- [ ] Read [CONTRIBUTING.md](https://github.com/iocage/iocage/blob/master/CONTRIBUTING.md) +- [ ] Read [CONTRIBUTING.md](https://github.com/freebsd/iocage/blob/master/CONTRIBUTING.md) diff --git a/README.md b/README.md index c968fb3f..ba6b683f 100644 --- a/README.md +++ b/README.md @@ -50,9 +50,7 @@ This repository replaces `iocage_legacy`. To upgrade to the current version: ## Links -- **[iocage Project Website](https://iocage.github.io/)** -- **[Documentation](http://iocage.readthedocs.org/en/latest/index.html)** -- **[Mailing list](https://groups.google.com/forum/#!forum/iocage)** +- **[iocage Project Website](https://freebsd.github.io/iocage/)** ## WARNING: - Some features of the previous iocage_legacy are either being dropped or simply not ported yet, feel free to open an issue asking about your favorite feature. But please search before opening a new one. PR's welcome for any feature you want! diff --git a/doc/.gitignore b/doc/.gitignore new file mode 100644 index 00000000..378eac25 --- /dev/null +++ b/doc/.gitignore @@ -0,0 +1 @@ +build diff --git a/doc/Makefile b/doc/Makefile index 9d252537..b8aa71fa 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -53,6 +53,8 @@ html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." + @rm -rf ../docs + cp -r $(BUILDDIR)/html ../docs .PHONY: dirhtml dirhtml: diff --git a/doc/build/doctrees/advanced-use.doctree b/doc/build/doctrees/advanced-use.doctree deleted file mode 100644 index 798ad23c0c18624197f09b70ca75f66c28493566..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 55938 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 s6~=2cj2(YTuxo-3UoI(EipF diff --git a/doc/build/doctrees/basic-use.doctree b/doc/build/doctrees/basic-use.doctree deleted file mode 100644 index 2d51361a01e5de7eb438375084ae8e0c719871cb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 59006 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 Yk*cPrsPH{kq-uXz7*DHA?TOL<2bXqiga7~l diff --git a/doc/build/doctrees/best-practices.doctree b/doc/build/doctrees/best-practices.doctree deleted file mode 100644 index bc1e32b274dd7f7466a3cf128b86d31f4d47bed8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14753 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 diff --git a/doc/build/doctrees/debian.doctree b/doc/build/doctrees/debian.doctree deleted file mode 100644 index 21237dc6d72d440c46e2218704135d4a8d24d22f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 12984 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 AH2?qr diff --git a/doc/build/doctrees/environment.pickle b/doc/build/doctrees/environment.pickle deleted file mode 100644 index d9a460296d4d6cf75695dac9f4b10522fef9dffe..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 264086 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 M=s51F&JJ(;e>sM5YybcN diff --git a/doc/build/doctrees/faq.doctree b/doc/build/doctrees/faq.doctree deleted file mode 100644 index d1f929f947790d9befe3078a0491f9bcacaf0974..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19002 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 NCb>*HvyE2j{|gXuEgJv; diff --git a/doc/build/doctrees/known-issues.doctree b/doc/build/doctrees/known-issues.doctree deleted file mode 100644 index 1cebb24400b23a70f1c3f895ffa03d45adaa9f83..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19247 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 + for more details. + +**Will iocage work on a generic system with no ZFS pools?** + No. ZFS is a must. If you run a FreeBSD server, you should be using + ZFS! + +**Is ZFS jailing supported?** + Yes, please refer to the :file:`iocage.8` manual page. diff --git a/docs/_sources/fastentrypoints.rst.txt b/docs/_sources/fastentrypoints.rst.txt new file mode 100644 index 00000000..0bd8c9d1 --- /dev/null +++ b/docs/_sources/fastentrypoints.rst.txt @@ -0,0 +1,7 @@ +fastentrypoints module +====================== + +.. automodule:: fastentrypoints + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_sources/index.rst.txt b/docs/_sources/index.rst.txt new file mode 100644 index 00000000..e63e20f3 --- /dev/null +++ b/docs/_sources/index.rst.txt @@ -0,0 +1,54 @@ +.. iocage documentation master file, created by + sphinx-quickstart on Wed Jul 9 10:19:09 2014. + You can adapt this file completely to your liking, but it should at + least contain the root `toctree` directive. + +=============================== +iocage - A FreeBSD Jail Manager +=============================== + +iocage is a jail/container manager written in Python, combining +some of the best features and technologies the FreeBSD operating system +has to offer. It is geared for ease of use with a simplistic and easy to +learn command syntax. + +**FEATURES:** + +- Templates, basejails, and normal jails +- Easy to use +- Rapid thin provisioning within seconds +- Automatic package installation +- Virtual networking stacks (vnet) +- Shared IP based jails (non vnet) +- Dedicated ZFS datasets inside jails +- Transparent ZFS snapshot management +- Binary updates +- Export and import +- And many more! + +Documentation: +-------------- + +.. toctree:: + :maxdepth: 2 + + install + basic-use + plugins + networking + jailtypes + best-practices + advanced-use + templates + debian + known-issues + faq + +.. Missing File: automatic-package-installation + +Indices and tables +================== + + * :ref:`genindex` + * :ref:`modindex` + * :ref:`search` diff --git a/docs/_sources/install.rst.txt b/docs/_sources/install.rst.txt new file mode 100644 index 00000000..bc6465a7 --- /dev/null +++ b/docs/_sources/install.rst.txt @@ -0,0 +1,201 @@ +.. index:: Install iocage +.. _Install iocage: + +Install iocage +============== + +iocage is a jail and container manager merging some of the best features +and technologies from the FreeBSD operating system. It is geared for +ease of use with simple command syntax. Visit the +`iocage github `_ for more information. + +Using binary packages ++++++++++++++++++++++ + +To install using binary packages on a FreeBSD system, run: + +:samp:`sudo pkg install py38-iocage` + +Using github +++++++++++++ + +If installing from github, the FreeBSD source tree **must** be located +at :samp:`$SRC_BASE` ( :samp:`/usr/src` by default). + +To install from github, run these commands: + +:samp:`pkg install python38 git-lite py38-cython py38-libzfs py38-pip` + +:samp:`git clone https://github.com/iocage/iocage` + +:samp:`make install` as root. + +.. tip:: To install subsequent updates run: :samp:`make install` as + root. + +Using pkg(8) +++++++++++++ + +It is possible to install pre-build packages using pkg(8) if using +FreeBSD 10 or above. + +To install using pkg(8), run: + +:samp:`sudo pkg install py38-iocage` + +Building Ports +++++++++++++++ + +iocage is in the FreeBSD ports tree as sysutils/py-iocage. + +Build the ports: +:samp:`cd /usr/ports/sysutils/iocage/ ; make install clean` + +Upgrading from :samp:`iocage_legacy` +++++++++++++++++++++++++++++++++++++ + +This repository replaces :samp:`iocage_legacy` . +To upgrade to the current version: + +1. Stop the jails ( :samp:`Service iocage stop; iocage stop ALL`) +#. Back up your data. +#. Remove the old :samp:`iocage` package if it is installed + ( :samp:`pkg delete iocage`) +#. Install :samp:`iocage` using one of the methods above. +#. Migrate the jails by running :samp:`iocage list` as root. +#. Start the jails ( :samp:`service iocage onestart`). + +.. index:: Ezjail Migration +.. _Ezjail Migration: + +Migrating from Ezjail to Iocage ++++++++++++++++++++++++++++++++ + +**Assumptions**: + +- ezjail jails are located at ``/usr/jails`` +- iocage jails are located at ``/iocage/jails`` + +Create Target +------------- + +Create an empty jail in iocage to act as the target for the migration. +The release and networking information will be updated with information +from ezjail. + +:: + + iocage create -e -n NewJail + +Copy Old Data +------------- + +Before data can be copied, another symlink must be created in the root +directory. Ezjail relies on symlinks to utlilize the basejail system, +however when looking in an existing jail, it’s symlinked to the root. + +:: + + % ls -ls /usr/jails/OldJail/bin + 1 lrwxr-xr-x 1 root wheel 13 Feb 22 2017 /usr/jails/OldJail/bin@ -> /basejail/bin + +This would work fine from within a running jail, but on the host +filesystem this link doesn’t currently exist. Because of this, create a +symlink from the basejail to the root filesystem of the jail host. + +:: + + ln -s /usr/jails/basejail /basejail + +Now that the link exists, copy the data from the ezjail jail directory +to the iocage jail directory. + +:: + + rsync -a --copy-links /usr/jails/OldJail/ /iocage/jails/NewJail/root/ + +Populate iocage config.json +--------------------------- + +There are 2 main parts from ezjail that need to be copied into the +iocage config: + +- release information +- IP address + +Release +~~~~~~~ + +The release info can be found in the old basejail files via the +``freebsd-update`` executable. + +:: + + $ grep USERLAND_VERSION= /usr/jails/basejail/bin/freebsd-version + USERLAND_VERSION="11.1-RELEASE-p6" + +This value goes into the “release” line of ``config.json`` + +:: + + "release": "11.1-RELEASE-p6", + +IP Address +~~~~~~~~~~ + +The IP addresses used in an ezjail jail are found in +``/usr/local/etc/ezjail/OldJail`` + +:: + + $ grep ip= /usr/local/etc/ezjail/OldJail + export jail_OldJail_ip="em0|192.168.1.10" + +This goes into the “ip4_addr” line of ``config.json`` + +:: + + "ip4_addr": "em0|192.168.1.10/24", + +Remember to append the subnet mask when adding network info to the +iocage config. + +Start the New Jail +~~~~~~~~~~~~~~~~~~ + +Make sure the old jail is shut down so there won’t be any IP conflicts. + +:: + + ezjail-admin stop OldJail + +Start the new jail with iocage + +:: + + iocage start NewJail + +(Optional) Update fstab +~~~~~~~~~~~~~~~~~~~~~~~ + +If there are other mounts in use in ezjail, these can be easily copied +into iocage as well. + +Ezjail fstab entries are located at ``/etc/fstab.OldJail`` on the host. + +:: + + $ cat /etc/fstab.OldJail + /usr/jails/basejail /usr/jails/OldJail/basejail nullfs ro 0 0 + /path/on/host /usr/jails/OldJail/path/in/jail nullfs rw 0 0 + +The basejail line isn’t needed in iocage if using the default jail type, +but the remaining entries need to be updated. + +Edit the fstab for the iocage jail and change the paths of the +mountpoint. + +:: + + $ cat /iocage/jails/NewJail/fstab + /path/on/host /iocage/jails/NewJail/root/path/in/jail nullfs rw 0 0 diff --git a/docs/_sources/iocage_cli.rst.txt b/docs/_sources/iocage_cli.rst.txt new file mode 100644 index 00000000..68227a67 --- /dev/null +++ b/docs/_sources/iocage_cli.rst.txt @@ -0,0 +1,246 @@ +iocage\_cli package +=================== + +Submodules +---------- + +iocage\_cli.activate module +--------------------------- + +.. automodule:: iocage_cli.activate + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.chroot module +------------------------- + +.. automodule:: iocage_cli.chroot + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.clean module +------------------------ + +.. automodule:: iocage_cli.clean + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.clone module +------------------------ + +.. automodule:: iocage_cli.clone + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.console module +-------------------------- + +.. automodule:: iocage_cli.console + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.create module +------------------------- + +.. automodule:: iocage_cli.create + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.debug module +------------------------ + +.. automodule:: iocage_cli.debug + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.destroy module +-------------------------- + +.. automodule:: iocage_cli.destroy + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.df module +--------------------- + +.. automodule:: iocage_cli.df + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.exec module +----------------------- + +.. automodule:: iocage_cli.exec + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.export module +------------------------- + +.. automodule:: iocage_cli.export + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.fetch module +------------------------ + +.. automodule:: iocage_cli.fetch + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.fstab module +------------------------ + +.. automodule:: iocage_cli.fstab + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.get module +---------------------- + +.. automodule:: iocage_cli.get + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.import module +------------------------- + +.. automodule:: iocage_cli.import + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.list module +----------------------- + +.. automodule:: iocage_cli.list + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.migrate module +-------------------------- + +.. automodule:: iocage_cli.migrate + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.pkg module +---------------------- + +.. automodule:: iocage_cli.pkg + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.rename module +------------------------- + +.. automodule:: iocage_cli.rename + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.restart module +-------------------------- + +.. automodule:: iocage_cli.restart + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.rollback module +--------------------------- + +.. automodule:: iocage_cli.rollback + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.set module +---------------------- + +.. automodule:: iocage_cli.set + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.snaplist module +--------------------------- + +.. automodule:: iocage_cli.snaplist + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.snapremove module +----------------------------- + +.. automodule:: iocage_cli.snapremove + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.snapshot module +--------------------------- + +.. automodule:: iocage_cli.snapshot + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.start module +------------------------ + +.. automodule:: iocage_cli.start + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.stop module +----------------------- + +.. automodule:: iocage_cli.stop + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.update module +------------------------- + +.. automodule:: iocage_cli.update + :members: + :undoc-members: + :show-inheritance: + +iocage\_cli.upgrade module +-------------------------- + +.. automodule:: iocage_cli.upgrade + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: iocage_cli + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_sources/iocage_lib.rst.txt b/docs/_sources/iocage_lib.rst.txt new file mode 100644 index 00000000..0150535c --- /dev/null +++ b/docs/_sources/iocage_lib.rst.txt @@ -0,0 +1,158 @@ +iocage\_lib package +=================== + +Submodules +---------- + +iocage\_lib.ioc\_check module +----------------------------- + +.. automodule:: iocage_lib.ioc_check + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_clean module +----------------------------- + +.. automodule:: iocage_lib.ioc_clean + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_common module +------------------------------ + +.. automodule:: iocage_lib.ioc_common + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_create module +------------------------------ + +.. automodule:: iocage_lib.ioc_create + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_debug module +----------------------------- + +.. automodule:: iocage_lib.ioc_debug + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_destroy module +------------------------------- + +.. automodule:: iocage_lib.ioc_destroy + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_exceptions module +---------------------------------- + +.. automodule:: iocage_lib.ioc_exceptions + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_exec module +---------------------------- + +.. automodule:: iocage_lib.ioc_exec + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_fetch module +----------------------------- + +.. automodule:: iocage_lib.ioc_fetch + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_fstab module +----------------------------- + +.. automodule:: iocage_lib.ioc_fstab + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_image module +----------------------------- + +.. automodule:: iocage_lib.ioc_image + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_json module +---------------------------- + +.. automodule:: iocage_lib.ioc_json + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_list module +---------------------------- + +.. automodule:: iocage_lib.ioc_list + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_plugin module +------------------------------ + +.. automodule:: iocage_lib.ioc_plugin + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_start module +----------------------------- + +.. automodule:: iocage_lib.ioc_start + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_stop module +---------------------------- + +.. automodule:: iocage_lib.ioc_stop + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.ioc\_upgrade module +------------------------------- + +.. automodule:: iocage_lib.ioc_upgrade + :members: + :undoc-members: + :show-inheritance: + +iocage\_lib.iocage module +------------------------- + +.. automodule:: iocage_lib.iocage + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: iocage_lib + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_sources/jailtypes.rst.txt b/docs/_sources/jailtypes.rst.txt new file mode 100644 index 00000000..f57dbcfd --- /dev/null +++ b/docs/_sources/jailtypes.rst.txt @@ -0,0 +1,105 @@ +.. index:: Jail Types +.. _Jail Types: + +Jail Types +========== + +iocage supports several different jail types: + +* Clone (default) +* Basejail +* Template +* Empty +* Thickjail + +All jail types have specific benefits and drawbacks, serving a variety +of unique needs. This section describes and has creation examples for +each of these jail types. + +.. index:: Clone Jails +.. _Clone: + +Clone (default) +--------------- + +Clone jails are created with: + +:samp:`# iocage create -r 11.0-RELEASE` + +Clone jails are duplicated from the appropriate RELEASE at creation +time. These consume a small amount of space, preserving only the +changing data. + +.. index:: Basejails +.. _Basejail: + +Basejail +-------- + +The original basejail concept was based on nullfs mounts. It was +popularized by `ezjail `_, +but :command:`iocage` basejails are a little different. Basejails in +:command:`iocage` are mounts in a jail **fstab** that are mounted at +jail startup. + +Create a basejail by typing: + +:command:`iocage create -r [RELEASE] -b` + +Basejails mount their **fstab** mounts at each startup. They are ideal +for environments where immediate patching or upgrading of multiple +jails is required. + +.. index:: Template Jails +.. _Template: + +Template +-------- + +Template jails are customized jails used to quickly create further +custom jails. + +For example, after creating a jail, the user customizes +that jail's networking properties. Once satisfied, the user then changes +the jail into a template with: + +:samp:`# iocage set template=yes examplejail` + +After this operation the jail is found in the *templates* list: + +:samp:`# iocage list -t` + +And new jails with the user customized networking can be created: + +:samp:`# iocage create -t examplejail -n newexamplejail` + +Template jails are convertable by setting the *template=* +property. + +.. index:: Empty Jails +.. _Empty: + +Empty +----- + +Empty jails are intended for unsupported jail setups or testing. Create +an empty jail with :command:`iocage create -e`. + +These are ideal for experimentation with unsupported RELEASES or Linux +jails. + +.. index:: Thickjail +.. _Thick: + +Thickjail +--------- + +Thickjails jails are created with: + +:samp:`# iocage create -T -r 11.2-RELEASE` + +Thickjails are copied from the appropriate RELEASE at creation +time. These consume a large amount of space, but are fully independent. + +These are ideal for transmission or synchronization between different +hosts with :command:`zfs send` and :command:`zfs receive`. diff --git a/docs/_sources/known-issues.rst.txt b/docs/_sources/known-issues.rst.txt new file mode 100644 index 00000000..26a99e12 --- /dev/null +++ b/docs/_sources/known-issues.rst.txt @@ -0,0 +1,97 @@ +.. index:: Known Issues +.. _Known Issues: + +Known Issues +============ + +This section provides a short list of known issues. + +.. index:: Known Issues, Mount Path Limit +.. _Mount Path Limit: + +Mount Path Limit +---------------- + +There is a known mountpoint path length limitation issue on FreeBSD. +Path length has an historical 88 character limit. + +This issue does not affect :command:`iocage` jails from functioning +properly, but can present challenges when diving into ZFS snapshots, +like :command:`cd` into :file:`.zfs/snapshots`, :command:`tar`, etc. + +ZFS snapshot creation and rollback is not affected. + +To work around this issue, :command:`iocage` allows the user to +assign and use a unique *NAME* for the jail. Alternately, using the +**[-s | --short]** flag at jail creation tells :command:`iocage` to +assign a shortened UUID to the jail. + +.. index:: Known Issues, VNET/VIMAGE +.. _VNETVIMAGE: + +VNET/VIMAGE Issues +------------------ + +VNET/VIMAGE can cause unexpected system crashes when VNET enabled jails +are destroyed. In other words, when the jail process is killed, removed, +or stopped. + +As a workaround, :command:`iocage` allows a soft restart without +destroying the jail. :command:`iocage restart -s [UUID | NAME]` executes +a soft restart of the jail. + +Example: + +:samp:`# iocage restart -s examplejail` + +FreeBSD 10.1-RELEASE is stable enough to run with VNET and soft +restarts. There are production machines with :command:`iocage` and VNET +jails running well over 100 days of uptime running both PF and IPFW. + +.. index:: Known Issues, VNET and ALTQ +.. _VNETVIMAGE and ALTQ: + +VNET/VIMAGE issues w/ ALTQ +++++++++++++++++++++++++++ + +As recent as FreeBSD 10.1-RELEASE-p10, there are some *interesting* +interactions between VNET/VIMAGE and the ALTernate Queueing (ALTQ) +system used by PF and other routing software. When compiling a kernel, +be sure these lines are **not** in the :file:`kernconf` file (unless +disabling VNET): + +.. code-block:: none + + options ALTQ + options ALTQ_CBQ + options ALTQ_RED + options ALTQ_RIO + options ALTQ_HFSC + options ALTQ_CDNR + options ALTQ_PRIQ + +Otherwise, when starting a jail with VNET support enabled, the host +system is likely to crash. Read a more about this issue from a +`2014 mailing list post `_. + +.. index:: Known Issues, IPv6 Host Bind Failure +.. _IPv6 Host Bind Failures: + +IPv6 host bind failures +----------------------- + +In some cases, a jail with an *ip6* address may take too long adding the +address to the interface. Services defined to bind specifically to the +address may then fail. If this happens, add this to :file:`sysctl.conf` +to disable DAD (duplicate address detection) probe packets: + +.. code-block:: none + + # disable duplicated address detection probe packets for jails + net.inet6.ip6.dad_count=0 + +Adding these lines permanently disables DAD. To set this for ONLY the +current system boot, type :command:`sysctl net.inet6.ip6.dad_count=0` in +a command line interface (CLI). More information about this issue is +available from a +`2013 mailing list post `_. diff --git a/docs/_sources/modules.rst.txt b/docs/_sources/modules.rst.txt new file mode 100644 index 00000000..32c264d1 --- /dev/null +++ b/docs/_sources/modules.rst.txt @@ -0,0 +1,11 @@ +iocage +====== + +.. toctree:: + :maxdepth: 4 + + fastentrypoints + iocage_cli + iocage_lib + setup + tests diff --git a/docs/_sources/networking.rst.txt b/docs/_sources/networking.rst.txt new file mode 100644 index 00000000..09744438 --- /dev/null +++ b/docs/_sources/networking.rst.txt @@ -0,0 +1,254 @@ +.. index:: Networking +.. _Networking: + +Networking +========== + +Jails have multiple networking options to better serve a user's needs. +Traditionally, jails have only supported IP alias based networking. This +is where an IP address is assigned to the host's interface and then used +by the jail for network communication. This is typically known as +"shared IP" based jails. + +Another recently developed option is called VNET or sometimes VIMAGE. +VNET is a fully virtualized networking stack which is isolated per jail. +VNET abstracts virtual network interfaces to jails, which then behave in +the same way as physical interfaces. + +By default, iocage does not enable VNET, but users can enable and +configure VNET for a jail by configuring that jail's properties using +the instructions in the :ref:`Configure a Jail` section of this +documentation. + +The rest of this section shows more depth of the **Shared IP** and +**VNET** networking options, along with instructions for +:ref:`Configuring Network Interfaces`. + +.. warning:: In the examples in this section, **em0** is used as the + network adapter. **em0** is a placeholder and must be replaced with + the user's specific network adapter. A network adapter is a computer + hardware component that connects a computer to a computer network. + In order to find the network adapter on the system run + :samp:`ifconfig`. + +.. index:: Shared IP +.. _Shared IP: + +Shared IP +--------- + +The *Shared IP* networking option is rock solid, with over a decade of +heavy use and testing. + +It has no specific system requirements, as everything needed is built +directly into the default GENERIC kernel. + +.. index:: Using Shared IP +.. _Using Shared IP: + +Using Shared IP ++++++++++++++++ + +There are a few steps to follow when setting up *Shared IP*: + +**Check the VNET property status** + +:samp:`# iocage get vnet examplejail1` + +If **vnet** is on, disable it: + +:samp:`# iocage set vnet=off examplejail1` + +**Configure an IP address** + +:samp:`# iocage set ip4_addr="em0|10.1.1.10/24" examplejail1` + +If multiple addresses are desired, separate the configuration directives +with a :kbd:`,`: + +:samp:`# iocage set ip4_addr="em0|10.1.1.10/24,em0|10.1.1.11/24" examplejail1` + +**Start the jail** + +:samp:`iocage start examplejail1` + +**Verify visible IP configuration in the jail** + +:samp:`# iocage exec examplejail1 ifconfig` + +.. index:: VIMAGE_VNET +.. _VIMAGEVNET: + +VIMAGE/VNET +----------- + +VNET is considered experimental. Unexpected system crashes +can occur. More details about issues with VNET are available in the +:ref:`Known Issues` section of this documentation. + +There are a number of required steps when configuring a jail to use +VNET: + +**Kernel** + +.. tip:: If not required, disable SCTP. + +Rebuild the kernel with these options: + +.. code-block:: none + + nooptions SCTP # Stream Control Transmission Protocol + options VIMAGE # VNET/Vimage support + options RACCT # Resource containers + options RCTL # same as above + +**/etc/rc.conf** + +On the host node, add this bridge configuration to :file:`/etc/rc.conf`: + +.. code-block:: none + + # set up bridge interface for iocage + cloned_interfaces="bridge0" + + # plumb interface em0 into bridge0 + ifconfig_bridge0="addm em0 up" + ifconfig_em0="up" + +**/etc/sysctl.conf** + +Add these tunables to :file:`/etc/sysctl.conf`: + +.. code-block:: none + + net.inet.ip.forwarding=1 # Enable IP forwarding between interfaces + net.link.bridge.pfil_onlyip=0 # Only pass IP packets when pfil is enabled + net.link.bridge.pfil_bridge=0 # Packet filter on the bridge interface + net.link.bridge.pfil_member=0 # Packet filter on the member interface + +**Enable vnet for the jail** + +:samp:`# iocage set vnet=on examplejail` + +**Configure jail's default gateway** + +:samp:`# iocage set defaultrouter=10.1.1.254 examplejail` + +**Configure an IP address** + +:samp:`iocage set ip4_addr="vnet0|10.1.1.10/24" examplejail` + +**Start jail and ping the default gateway** + +Start the jail: + +:samp:`# iocage start examplejail` + +Open the system console inside the jail: + +:samp:`iocage console examplejail` + +Ping the previously configured default gateway: + +:samp:`# ping 10.1.1.254` + +.. index:: VNET tips +.. _VNET Tips: + +Tips +++++ + +**Routes** + +Be sure the default gateway knows the route back to the VNET subnets. + +**Using VLANs** + +To assign a jail's traffic to a VLAN, add the VLAN interface as a bridge +member, but not the VLAN's parent. For example: + +.. code-block:: none + + sysrc vlans_em0="666" + sysrc ifconfig_em0_666="up" + iocage set vnet_default_interface="em0.666" examplejail + iocage set interfaces="vnet1:bridge1" examplejail + + +If using VLAN interfaces for the jail host only, on the other hand, add the +parent as a bridge member, but not the VLAN interface. + +.. code-block:: none + + sysrc vlans_em0="666" + sysrc ifconfig_em0_666="1.2.3.4/24" + iocage set vnet_default_interface="auto" examplejail # "em0" would also work + iocage set interfaces="vnet1:bridge1" examplejail + +.. index:: Configure Network Interfaces +.. _Configuring Network Interfaces: + +Configuring Network Interfaces +------------------------------ + +:command:`iocage` transparently handles network configuration for both +*Shared IP* and *VNET* jails. + +.. index:: Configure Shared IP jail +.. _Configuring a Shared IP Jail: + +Configuring a Shared IP Jail +++++++++++++++++++++++++++++ + +**IPv4** + +:samp:`# iocage set ip4_addr="em0|192.168.0.10/24" examplejail` + +**IPv6** + +:samp:`# iocage set ip6_addr="em0|2001:123:456:242::5/64" examplejail` + +These examples add IP alias *192.168.0.10/24* and *2001:123:456::5/64* +to interface *em0* of the shared IP jail, at start time. + +.. index:: Configure VNET Jail +.. _Configuring a VNET Jail: + +Configuring a VNET Jail ++++++++++++++++++++++++ + +To configure both IPv4 and IPv6: + +:samp:`# iocage set ip4_addr="vnet0|192.168.0.10/24" examplejail` + +:samp:`# iocage set ip6_addr="vnet0|2001:123:456:242::5/64" examplejail` + +:samp:`# iocage set defaultrouter6="2001:123:456:242::1" examplejail` + +.. note:: For VNET jails, a default route has to also be specified. + +To create a a jail with a DHCP interface add the `dhcp=on` property: + +:samp:`# iocage create -r 11.0-RELEASE --name myjail dhcp=on` + +The `dhcp=on` property implies creating a VNET virtual network stack and +enabling the Berkley Packet Filter. DHCP cannot work without VNET. +More information about VNET is available in the VNET(9) FreeBSD manual page. + +.. index:: Tips for configuring VNET +.. _Tips for Configuring VNET: + +Tips for Configuring VNET ++++++++++++++++++++++++++ + +To start a jail with no IPv4/6 address, **set** the *ip4_addr* and +*ip6_addr* properties, then the *defaultrouter* and *defaultrouter6* +properties: + +:samp:`# iocage set ip4_addr=none ip6_addr=none examplejail` + +:samp:`# iocage set defaultrouter=none defaultrouter6=none examplejail` + +Force iocage to regenerate the MAC and HW address (e.g.: after cloning a jail). This will cause the MAC and HW addresses to be regenerated when the jail is next started. + +:samp:`# iocage set vnet0_mac=none examplejail` diff --git a/docs/_sources/plugins.rst.txt b/docs/_sources/plugins.rst.txt new file mode 100644 index 00000000..77d96115 --- /dev/null +++ b/docs/_sources/plugins.rst.txt @@ -0,0 +1,126 @@ +.. index:: Plugins +.. _Plugins: + +Plugins +======= + +iocage plugins are a simple and very fast method to get application +containers installed and configured. At its core, a plugin is a jail +specifically running one program. Popular programs can be installed +repeatedly with one line. Additionally, plugins are easily extended by +users, offering a high level of customizability and functionality. + +In structure, a plugin consists of :file:`.json` manifest and +:file:`.png` icon files. + + +**See what's available** + + +To see a list of all currently available plugins, open a command line +and type :command:`iocage list -PR` or +:command:`iocage list --plugins --remote`. The full +`iocage plugin list `_ +is also available on GitHub. + +Check which plugins are installed on the system with +:command:`iocage list --plugins` or :command:`iocage list -P`. + + +**Getting started with plugins** + + +.. note:: iocage needs to be `activated `_ before + plugins can be installed or modified! + + +To get started, open a command line and type +:command:`iocage fetch --plugins ip4_addr="IF|IP"`. This initial +:command:`fetch` also supports *dhcp* in the same manner as +:command:`iocage create`. The IP listed for the plugin needs to +be a valid IP not already in use. Use the *- -name* flag to easily fetch a +specific plugin: + +:samp:`$ iocage fetch --plugins --name plexmediaserver ip4_addr="igb0|192.168.0.91"` + +If available, plugins can also be fetched locally with +:command:`iocage fetch -P the/path/to/plugin.json ip4_addr="re0|192.168.0.100"` + + +.. tip:: Using :command:`iocage fetch` locally is very useful when + testing an in-development plugin. + + +After fetching a plugin, view of all its properties with +:command:`iocage get -a NAME|UUID | less`. Individual properties are +found with :command:`iocage get PROPERTY`: + +:samp:`$ iocage get type quasselcore` + +Adjust the plugin properties with :command:`iocage set`: + +:samp:`$ iocage set PROPERTY quasselcore` + + +:command:`iocage set` is used to configure +that plugin. In this example, a complete Quasselcore plugin is +installed to a FreeNAS system, then the note of the plugin is changed: + +.. code-block:: none + + [root@freenas ~]# iocage fetch --plugins --name quasselcore ip4_addr="em0|192.168.1.50" + [root@freenas ~]# iocage set notes="Hello world" quasselcore + [root@freenas ~]# iocage get notes quasselcore + Hello world + + +**Upgrading and updating plugins** + + +The process for upgrading and updating plugins is exactly the same as +normal jails. See :ref:`Updating Jails` or :ref:`Upgrading Jails` . + + +**Plugin Manifest Example** + + +Following is an example of a plugin manifest: + +.. sourcecode:: json + + { + "name": "default_jail_name_here", + "release": "11.3-RELEASE", + "artifact": "https://github.com/git_path_to_plugin_repo", + "official": false, + "properties": { + "nat": 1, + "nat_forwards": "tcp(7878:7878)" + }, + "devfs_ruleset": { + "paths": {"bpf*": null}, + "includes": [] + }, + "pkgs": [ + ], + "packagesite": "http://pkg.FreeBSD.org/${ABI}/latest", + "fingerprints": { + "iocage-plugins": [ + { + "function": "sha256", + "fingerprint": "b0170035af3acc5f3f3ae1859dc717101b4e6c1d0a794ad554928ca0cbb2f438" + } + ] + }, + "revision": 0 + } + +* **devfs_ruleset**: It should be a valid dictionary object where "paths" must be specified. Value of "paths" is a + dictionary where keys are the path to be added and the value is the mode to be used. `null` translates to `unhide`. + For any include specified, please refer to the following example which shows how each path specified is added as + iocage dynamically generates a devfs ruleset and how an include is added to the ruleset: + +.. sourcecode:: shell + + devfs rule -s ruleset_number add path bpf* unhide + devfs rule -s ruleset_number add include include_value diff --git a/docs/_sources/setup.rst.txt b/docs/_sources/setup.rst.txt new file mode 100644 index 00000000..31789b12 --- /dev/null +++ b/docs/_sources/setup.rst.txt @@ -0,0 +1,7 @@ +setup module +============ + +.. automodule:: setup + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_sources/templates.rst.txt b/docs/_sources/templates.rst.txt new file mode 100644 index 00000000..211d70f9 --- /dev/null +++ b/docs/_sources/templates.rst.txt @@ -0,0 +1,91 @@ +.. index:: Using Templates +.. _Using Templates: + +Using Templates +=============== + +**Templates can save precious time!** + +Set up a jail and create a template from it. All packages and +preconfigured settings remain available for deployment to new jails +within seconds. + +Any jail can be converted between jail and template as needed. +Essentially, a template is just another jail which has the property +**template** set to **yes**. The difference is templates are not started +by :command:`iocage`. + +**Create a template with iocage:** + +1. Create a jail: :samp:`# iocage create -r 11.0-RELEASE -n mytemplate`. +2. Configure the jail's networking. +3. Install packages and/or customize the jail as needed. +4. Once finished with customization, stop the jail: + :samp:`# iocage stop mytemplate`. +5. It is recommended to add notes to the jail, so the specific jail + customizations are easily remembered: + :samp:`# iocage set notes="customized PHP,nginx jail" mytemplate` +6. Set the **template** property **on**: + :samp:`# iocage set template=yes mytemplate`. +7. Find the new template with :command:`iocage list -t`. + +**Use the created template:** + +Use :command:`iocage create -t` to create a new jail from the new +template: + +1. :samp:`# iocage create -t mytemplate -n jailfromtemplate` +2. Find the new jail with :command:`iocage list`. +3. Start the jail with :samp:`# iocage start jailfromtemplate`. + +Done! + +**Customizing a template:** + +To make changes to the template, you will need to know whether any existing +jails are based on the template. Since modifying the template will require +converting it back into a jail, it cannot be the base for any jails. + +*** No jails based on the template *** + +1. Convert the template back into a jail: + + :command:`iocage set template=no [UUID | NAME]`. + +2. Start the jail: + + :command:`iocage start [UUID | NAME]`. + +3. Use any method you wish to connect to the jail and modify its contents. + +4. Stop the jail: + + :command:`iocage stop [UUID | NAME]`. + +5. Convert the jail back into a template: + + :command:`iocage set template=yes [UUID | NAME]`. + +*** Jails based on the template *** + +This process will create a new template, leaving the existing template +and jails unaffected. + +1. Create a 'thick' jail from the template, so that it will be independent + from the template: + + :command:`iocage create -T -t [UUID | NAME] -n newtemplate`. + +2. Start the jail: + + :command:`iocage start newtemplate`. + +3. Use any method you wish to connect to the jail and modify its contents. + +4. Stop the jail: + + :command:`iocage stop newtemplate`. + +5. Convert the jail into a template: + + :command:`iocage set template=yes newtemplate`. diff --git a/docs/_sources/tests.rst.txt b/docs/_sources/tests.rst.txt new file mode 100644 index 00000000..4789412a --- /dev/null +++ b/docs/_sources/tests.rst.txt @@ -0,0 +1,30 @@ +tests package +============= + +Submodules +---------- + +tests.conftest module +--------------------- + +.. automodule:: tests.conftest + :members: + :undoc-members: + :show-inheritance: + +tests.data\_classes module +-------------------------- + +.. automodule:: tests.data_classes + :members: + :undoc-members: + :show-inheritance: + + +Module contents +--------------- + +.. automodule:: tests + :members: + :undoc-members: + :show-inheritance: diff --git a/docs/_static/_sphinx_javascript_frameworks_compat.js b/docs/_static/_sphinx_javascript_frameworks_compat.js new file mode 100644 index 00000000..8549469d --- /dev/null +++ b/docs/_static/_sphinx_javascript_frameworks_compat.js @@ -0,0 +1,134 @@ +/* + * _sphinx_javascript_frameworks_compat.js + * ~~~~~~~~~~ + * + * Compatability shim for jQuery and underscores.js. + * + * WILL BE REMOVED IN Sphinx 6.0 + * xref RemovedInSphinx60Warning + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} diff --git a/docs/_static/agogo.css b/docs/_static/agogo.css new file mode 100644 index 00000000..0260ce7f --- /dev/null +++ b/docs/_static/agogo.css @@ -0,0 +1,549 @@ +/* + * agogo.css_t + * ~~~~~~~~~~~ + * + * Sphinx stylesheet -- agogo theme. + * + * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +* { + margin: 0px; + padding: 0px; +} + +body { + font-family: "Verdana", Arial, sans-serif; + line-height: 1.4em; + color: black; + background-color: #eeeeec; +} + + +/* Page layout */ + +div.header, div.content, div.footer { + width: 70em; + margin-left: auto; + margin-right: auto; +} + +div.header-wrapper { + background: #555 top left repeat-x; + border-bottom: 3px solid #2e3436; +} + + +/* Default body styles */ +a { + color: #ce5c00; +} + +div.bodywrapper a, div.footer a { + text-decoration: underline; +} + +.clearer { + clear: both; +} + +.left { + float: left; +} + +.right { + float: right; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +h1, h2, h3, h4 { + font-family: "Georgia", "Times New Roman", serif; + font-weight: normal; + color: #3465a4; + margin-bottom: .8em; +} + +h1 { + color: #204a87; +} + +h2 { + padding-bottom: .5em; + border-bottom: 1px solid #3465a4; +} + +a.headerlink { + visibility: hidden; + color: #dddddd; + padding-left: .3em; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +img { + border: 0; +} + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 2px 7px 1px 7px; + border-left: 0.2em solid black; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +/* Header */ + +div.header { + padding-top: 10px; + padding-bottom: 10px; +} + +div.header .headertitle { + font-family: "Georgia", "Times New Roman", serif; + font-weight: normal; + font-size: 180%; + letter-spacing: .08em; + margin-bottom: .8em; +} + +div.header .headertitle a { + color: white; +} + +div.header div.rel { + margin-top: 1em; +} + +div.header div.rel a { + color: #fcaf3e; + letter-spacing: .1em; + text-transform: uppercase; +} + +p.logo { + float: right; +} + +img.logo { + border: 0; +} + + +/* Content */ +div.content-wrapper { + background-color: white; + padding-top: 20px; + padding-bottom: 20px; +} + +div.document { + width: 50em; + float: left; +} + +div.body { + padding-right: 2em; + text-align: justify; +} + +div.document h1 { + line-height: 120%; +} + +div.document ul { + margin: 1.5em; + list-style-type: square; +} + +div.document dd { + margin-left: 1.2em; + margin-top: .4em; + margin-bottom: 1em; +} + +div.document .section { + margin-top: 1.7em; +} +div.document .section:first-child { + margin-top: 0px; +} + +div.document div.highlight { + padding: 3px; + border-top: 2px solid #dddddd; + border-bottom: 2px solid #dddddd; + margin-top: .8em; + margin-bottom: .8em; +} + +div.document div.literal-block-wrapper { + margin-top: .8em; + margin-bottom: .8em; +} + +div.document div.literal-block-wrapper div.highlight { + margin: 0; +} + +div.document div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.document div.code-block-caption span.caption-text { +} + +div.document h2 { + margin-top: .7em; +} + +div.document p { + margin-bottom: .5em; +} + +div.document li.toctree-l1 { + margin-bottom: 1em; +} + +div.document .descname { + font-weight: bold; +} + +div.document .sig-paren { + font-size: larger; +} + +div.document .docutils.literal { + background-color: #eeeeec; + padding: 1px; +} + +div.document .docutils.xref.literal { + background-color: transparent; + padding: 0px; +} + +div.document blockquote { + margin: 1em; +} + +div.document ol { + margin: 1.5em; +} + + +/* Sidebar */ + +div.sidebar, +aside.sidebar { + width: 20em; + float: right; + font-size: .9em; +} + +div.sidebar a, aside.sidebar a, div.header a { + text-decoration: none; +} + +div.sidebar a:hover, aside.sidebar a:hover, div.header a:hover { + text-decoration: underline; +} + +div.sidebar h3, +aside.sidebar h3 { + color: #2e3436; + text-transform: uppercase; + font-size: 130%; + letter-spacing: .1em; +} + +div.sidebar ul, +aside.sidebar ul { + list-style-type: none; +} + +div.sidebar li.toctree-l1 a, +aside.sidebar li.toctree-l1 a { + display: block; + padding: 1px; + border: 1px solid #dddddd; + background-color: #eeeeec; + margin-bottom: .4em; + padding-left: 3px; + color: #2e3436; +} + +div.sidebar li.toctree-l2 a, +aside.sidebar li.toctree-l2 a { + background-color: transparent; + border: none; + margin-left: 1em; + border-bottom: 1px solid #dddddd; +} + +div.sidebar li.toctree-l3 a, +aside.sidebar li.toctree-l3 a { + background-color: transparent; + border: none; + margin-left: 2em; + border-bottom: 1px solid #dddddd; +} + +div.sidebar li.toctree-l2:last-child a, +aside.sidebar li.toctree-l2:last-child a { + border-bottom: none; +} + +div.sidebar li.toctree-l1.current a, +aside.sidebar li.toctree-l1.current a { + border-right: 5px solid #fcaf3e; +} + +div.sidebar li.toctree-l1.current li.toctree-l2 a, +aside.sidebar li.toctree-l1.current li.toctree-l2 a { + border-right: none; +} + +div.sidebar input[type="text"], +aside.sidebar input[type="text"] { + width: 170px; +} + +div.sidebar input[type="submit"], +aside.sidebar input[type="submit"] { + width: 30px; +} + + +/* Footer */ + +div.footer-wrapper { + background: url(bgfooter.png) top left repeat-x; + border-top: 4px solid #babdb6; + padding-top: 10px; + padding-bottom: 10px; + min-height: 80px; +} + +div.footer, div.footer a { + color: #888a85; +} + +div.footer .right { + text-align: right; +} + +div.footer .left { + text-transform: uppercase; +} + + +/* Styles copied from basic theme */ + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- viewcode extension ---------------------------------------------------- */ + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family:: "Verdana", Arial, sans-serif; +} + +div.viewcode-block:target { + margin: -1px -3px; + padding: 0 3px; + background-color: #f4debf; + border-top: 1px solid #ac9; + border-bottom: 1px solid #ac9; +} + +div.code-block-caption { + background-color: #ddd; + color: #333; + padding: 2px 5px; + font-size: small; +} + +/* -- math display ---------------------------------------------------------- */ + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} \ No newline at end of file diff --git a/doc/build/html/_static/ajax-loader.gif b/docs/_static/ajax-loader.gif similarity index 100% rename from doc/build/html/_static/ajax-loader.gif rename to docs/_static/ajax-loader.gif diff --git a/doc/build/html/_static/basic.css b/docs/_static/basic.css similarity index 100% rename from doc/build/html/_static/basic.css rename to docs/_static/basic.css diff --git a/docs/_static/bgfooter.png b/docs/_static/bgfooter.png new file mode 100644 index 0000000000000000000000000000000000000000..b7c7cadd4e6978aa7081fe672fcf5afc97516bda GIT binary patch literal 276 zcmV+v0qg#WP)qvnR6EfsQ*t~7O=UY2%BZy- zs#7>Lw$#|1-#yb5jZ8}CcXenmE?Bb?+emvZy3eu4G&!aT9i`%Ot1U0%(#mRx?NNc)^t8TJHA0R4$Di^IIL4X9&MVm&N-9#bE;?}xqq}wTrc0WUU#YK z#2JfT+O{=ipwX3&j4H~AegD$wD(9Ee_Le?vx(rq^B%Dj?^+nzae0J!bK00|W&N)Yz aUi|<^NiO;Hz(H~V0000P0IhA`JcOe?|*M3M!YD+&^mI=Y=U~-8S>8l1XAJ*3?jZZ Q8UO$Q07*qoM6N<$f;!4|TmS$7 literal 0 HcmV?d00001 diff --git a/doc/build/html/_static/comment-bright.png b/docs/_static/comment-bright.png similarity index 100% rename from doc/build/html/_static/comment-bright.png rename to docs/_static/comment-bright.png diff --git a/doc/build/html/_static/comment-close.png b/docs/_static/comment-close.png similarity index 100% rename from doc/build/html/_static/comment-close.png rename to docs/_static/comment-close.png diff --git a/doc/build/html/_static/comment.png b/docs/_static/comment.png similarity index 100% rename from doc/build/html/_static/comment.png rename to docs/_static/comment.png diff --git a/doc/build/html/_static/doctools.js b/docs/_static/doctools.js similarity index 100% rename from doc/build/html/_static/doctools.js rename to docs/_static/doctools.js diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js new file mode 100644 index 00000000..61ed8cfb --- /dev/null +++ b/docs/_static/documentation_options.js @@ -0,0 +1,14 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '1.9', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/doc/build/html/_static/down-pressed.png b/docs/_static/down-pressed.png similarity index 100% rename from doc/build/html/_static/down-pressed.png rename to docs/_static/down-pressed.png diff --git a/doc/build/html/_static/down.png b/docs/_static/down.png similarity index 100% rename from doc/build/html/_static/down.png rename to docs/_static/down.png diff --git a/doc/build/html/_static/file.png b/docs/_static/file.png similarity index 100% rename from doc/build/html/_static/file.png rename to docs/_static/file.png diff --git a/docs/_static/jquery-3.6.0.js b/docs/_static/jquery-3.6.0.js new file mode 100644 index 00000000..fc6c299b --- /dev/null +++ b/docs/_static/jquery-3.6.0.js @@ -0,0 +1,10881 @@ +/*! + * jQuery JavaScript Library v3.6.0 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright OpenJS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2021-03-02T17:08Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 + // Plus for old WebKit, typeof returns "function" for HTML collections + // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) + return typeof obj === "function" && typeof obj.nodeType !== "number" && + typeof obj.item !== "function"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.6.0", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), + function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); + } ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.6 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2021-02-16 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem && elem.namespaceURI, + docElem = elem && ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +} +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the primary Deferred + primary = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + primary.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( primary.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return primary.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); + } + + return primary.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
" ], + col: [ 2, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + + // Support: Chrome 86+ + // In Chrome, if an element having a focusout handler is blurred by + // clicking outside of it, it invokes the handler synchronously. If + // that handler calls `.remove()` on the element, the data is cleared, + // leaving `result` undefined. We need to guard against this. + return result && result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + which: true +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + // Suppress native focus or blur as it's already being fired + // in leverageNative. + _default: function() { + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + // + // Support: Firefox 70+ + // Only Firefox includes border widths + // in computed dimensions. (gh-4529) + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; + tr.style.cssText = "border:1px solid"; + + // Support: Chrome 86+ + // Height set through cssText does not get applied. + // Computed height then comes back as 0. + tr.style.height = "1px"; + trChild.style.height = "9px"; + + // Support: Android 8 Chrome 86+ + // In our bodyBackground.html iframe, + // display for all div elements is set to "inline", + // which causes a problem only in Android 8 Chrome 86. + // Ensuring the div is display: block + // gets around this issue. + trChild.style.display = "block"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + + parseInt( trStyle.borderTopWidth, 10 ) + + parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml, parserErrorElem; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) {} + + parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; + if ( !xml || parserErrorElem ) { + jQuery.error( "Invalid XML: " + ( + parserErrorElem ? + jQuery.map( parserErrorElem.childNodes, function( el ) { + return el.textContent; + } ).join( "\n" ) : + data + ) ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ).filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ).map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + +originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script but not if jsonp + if ( !isSuccess && + jQuery.inArray( "script", s.dataTypes ) > -1 && + jQuery.inArray( "json", s.dataTypes ) < 0 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

fastentrypoints module

+

Monkey patch setuptools to write faster console_scripts with this format:

+
+

import sys +from mymodule import entry_function +sys.exit(entry_function())

+
+

This is better.

+

(c) 2016, Aaron Christianson +http://github.com/ninjaaron/fast-entry_points

+
+
+fastentrypoints.get_args()
+

Yield write_script() argument tuples for a distribution’s +console_scripts and gui_scripts entry points.

+
+ +
+
+fastentrypoints.main()
+
+ +
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/doc/build/html/genindex.html b/docs/genindex.html similarity index 100% rename from doc/build/html/genindex.html rename to docs/genindex.html diff --git a/doc/build/html/index.html b/docs/index.html similarity index 100% rename from doc/build/html/index.html rename to docs/index.html diff --git a/docs/install.html b/docs/install.html new file mode 100644 index 00000000..1dcb7a1a --- /dev/null +++ b/docs/install.html @@ -0,0 +1,279 @@ + + + + + + + + + Install iocage — iocage 1.9 documentation + + + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

Install iocage

+

iocage is a jail and container manager merging some of the best features +and technologies from the FreeBSD operating system. It is geared for +ease of use with simple command syntax. Visit the +iocage github for more information.

+
+

Using binary packages

+

To install using binary packages on a FreeBSD system, run:

+

sudo pkg install py38-iocage

+
+
+

Using github

+

If installing from github, the FreeBSD source tree must be located +at $SRC_BASE ( /usr/src by default).

+

To install from github, run these commands:

+

pkg install python38 git-lite py38-cython py38-libzfs py38-pip

+

git clone https://github.com/iocage/iocage

+

make install as root.

+
+

Tip

+

To install subsequent updates run: make install as +root.

+
+
+
+

Using pkg(8)

+

It is possible to install pre-build packages using pkg(8) if using +FreeBSD 10 or above.

+

To install using pkg(8), run:

+

sudo pkg install py38-iocage

+
+
+

Building Ports

+

iocage is in the FreeBSD ports tree as sysutils/py-iocage.

+

Build the ports: +cd /usr/ports/sysutils/iocage/ ; make install clean

+
+
+

Upgrading from iocage_legacy

+

This repository replaces iocage_legacy . +To upgrade to the current version:

+
    +

  1. Stop the jails ( Service iocage stop; iocage stop ALL)

    2. +

  2. Back up your data.

    3. +

  3. Remove the old iocage package if it is installed +( pkg delete iocage)

    4. +

  4. Install iocage using one of the methods above.

    5. +

  5. Migrate the jails by running iocage list as root.

    6. +

  6. Start the jails ( service iocage onestart).

    7. +
+
+
+

Migrating from Ezjail to Iocage

+

Assumptions:

+
    +

  • ezjail jails are located at /usr/jails

    • +

  • iocage jails are located at /iocage/jails

    • +
+
+

Create Target

+

Create an empty jail in iocage to act as the target for the migration. +The release and networking information will be updated with information +from ezjail.

+
iocage create -e -n NewJail
+
+
+
+
+

Copy Old Data

+

Before data can be copied, another symlink must be created in the root +directory. Ezjail relies on symlinks to utlilize the basejail system, +however when looking in an existing jail, it’s symlinked to the root.

+
% ls -ls /usr/jails/OldJail/bin
+1 lrwxr-xr-x  1 root  wheel  13 Feb 22  2017 /usr/jails/OldJail/bin@ -> /basejail/bin
+
+
+

This would work fine from within a running jail, but on the host +filesystem this link doesn’t currently exist. Because of this, create a +symlink from the basejail to the root filesystem of the jail host.

+
ln -s /usr/jails/basejail /basejail
+
+
+

Now that the link exists, copy the data from the ezjail jail directory +to the iocage jail directory.

+
rsync -a --copy-links /usr/jails/OldJail/ /iocage/jails/NewJail/root/
+
+
+
+
+

Populate iocage config.json

+

There are 2 main parts from ezjail that need to be copied into the +iocage config:

+
    +

  • release information

    • +

  • IP address

    • +
+
+

Release

+

The release info can be found in the old basejail files via the +freebsd-update executable.

+
$ grep USERLAND_VERSION= /usr/jails/basejail/bin/freebsd-version
+USERLAND_VERSION="11.1-RELEASE-p6"
+
+
+

This value goes into the “release” line of config.json

+
"release": "11.1-RELEASE-p6",
+
+
+
+
+

IP Address

+

The IP addresses used in an ezjail jail are found in +/usr/local/etc/ezjail/OldJail

+
$ grep ip= /usr/local/etc/ezjail/OldJail
+export jail_OldJail_ip="em0|192.168.1.10"
+
+
+

This goes into the “ip4_addr” line of config.json

+
"ip4_addr": "em0|192.168.1.10/24",
+
+
+

Remember to append the subnet mask when adding network info to the +iocage config.

+
+
+

Start the New Jail

+

Make sure the old jail is shut down so there won’t be any IP conflicts.

+
ezjail-admin stop OldJail
+
+
+

Start the new jail with iocage

+
iocage start NewJail
+
+
+
+
+

(Optional) Update fstab

+

If there are other mounts in use in ezjail, these can be easily copied +into iocage as well.

+

Ezjail fstab entries are located at /etc/fstab.OldJail on the host.

+
$ cat /etc/fstab.OldJail
+/usr/jails/basejail /usr/jails/OldJail/basejail   nullfs   ro   0   0
+/path/on/host /usr/jails/OldJail/path/in/jail   nullfs   rw   0   0
+
+
+

The basejail line isn’t needed in iocage if using the default jail type, +but the remaining entries need to be updated.

+

Edit the fstab for the iocage jail and change the paths of the +mountpoint.

+
$ cat /iocage/jails/NewJail/fstab
+/path/on/host /iocage/jails/NewJail/root/path/in/jail   nullfs   rw   0   0
+
+
+
+
+
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ previous | + next | + modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/docs/iocage_cli.html b/docs/iocage_cli.html new file mode 100644 index 00000000..e332ac59 --- /dev/null +++ b/docs/iocage_cli.html @@ -0,0 +1,305 @@ + + + + + + + + + iocage_cli package — iocage 1.9 documentation + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

iocage_cli package

+
+

Submodules

+
+
+

iocage_cli.activate module

+

activate module for the cli.

+
+
+

iocage_cli.chroot module

+

chroot module for the cli.

+
+
+

iocage_cli.clean module

+

clean module for the cli.

+
+
+

iocage_cli.clone module

+

clone module for the cli.

+
+
+iocage_cli.clone.validate_count(ctx, param, value)
+

Takes a string, removes the commas and returns an int.

+
+ +
+
+

iocage_cli.console module

+

console module for the cli.

+
+
+

iocage_cli.create module

+

create module for the cli.

+
+
+iocage_cli.create.validate_count(ctx, param, value)
+

Takes a string, removes the commas and returns an int.

+
+ +
+
+

iocage_cli.debug module

+

debug module for the cli.

+
+
+

iocage_cli.destroy module

+

destroy module for the cli.

+
+
+iocage_cli.destroy.child_test(iocroot, name, _type, force=False, recursive=False)
+

Tests for dependent children

+
+ +
+
+

iocage_cli.df module

+

df module for the cli.

+
+
+

iocage_cli.exec module

+

exec module for the cli.

+
+
+

iocage_cli.export module

+

export module for the cli.

+
+
+

iocage_cli.fetch module

+

fetch module for the cli.

+
+
+iocage_cli.fetch.validate_count(ctx, param, value)
+

Takes a string, removes the commas and returns an int.

+
+ +
+
+

iocage_cli.fstab module

+

fstab module for the cli.

+
+
+

iocage_cli.get module

+

get module for the cli.

+
+
+

iocage_cli.import module

+

import module for the cli.

+
+
+

iocage_cli.list module

+

list module for the cli.

+
+
+

iocage_cli.migrate module

+

migrate module for the cli.

+
+
+

iocage_cli.pkg module

+

pkg module for the cli.

+
+
+

iocage_cli.rename module

+

rename module for the cli.

+
+
+

iocage_cli.restart module

+

restart module for the cli.

+
+
+

iocage_cli.rollback module

+

rollback module for the cli.

+
+
+

iocage_cli.set module

+

set module for the cli.

+
+
+

iocage_cli.snaplist module

+

snaplist module for the cli.

+
+
+

iocage_cli.snapremove module

+

snapremove module for the cli.

+
+
+

iocage_cli.snapshot module

+

snapshot module for the cli.

+
+
+

iocage_cli.start module

+

start module for the cli.

+
+
+

iocage_cli.stop module

+

stop module for the cli.

+
+
+

iocage_cli.update module

+

update module for the cli.

+
+
+

iocage_cli.upgrade module

+

upgrade module for the cli.

+
+
+

Module contents

+

The main CLI for ioc.

+
+
+class iocage_cli.IOCLogger
+

Bases: object

+
+
+setConsoleLogLevel(level)
+
+ +
+ +
+
+class iocage_cli.IOCageCLI(name: Optional[str] = None, invoke_without_command: bool = False, no_args_is_help: Optional[bool] = None, subcommand_metavar: Optional[str] = None, chain: bool = False, result_callback: Optional[Callable[[...], Any]] = None, **attrs: Any)
+

Bases: MultiCommand

+

Iterates in the ‘cli’ directory and will load any module’s cli definition.

+
+
+get_command(ctx, name)
+

Given a context and a command name, this returns a +Command object if it exists or returns None.

+
+ +
+
+list_commands(ctx)
+

Returns a list of subcommand names in the order they should +appear.

+
+ +
+ +
+
+class iocage_cli.InfoHandler(level=0)
+

Bases: Handler

+
+
+emit(record)
+

Do whatever it takes to actually log the specified logging record.

+

This version is intended to be implemented by subclasses and so +raises a NotImplementedError.

+
+ +
+ +
+
+iocage_cli.print_version(ctx, param, value)
+

Prints the version and then exits.

+
+ +
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/docs/iocage_lib.html b/docs/iocage_lib.html new file mode 100644 index 00000000..914baf0a --- /dev/null +++ b/docs/iocage_lib.html @@ -0,0 +1,1634 @@ + + + + + + + + + iocage_lib package — iocage 1.9 documentation + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

iocage_lib package

+
+

Submodules

+
+
+

iocage_lib.ioc_check module

+

Check datasets before execution

+
+
+class iocage_lib.ioc_check.IOCCheck(silent=False, callback=None, migrate=False, reset_cache=False)
+

Bases: object

+

Checks if the required iocage datasets are present

+
+ +
+
+

iocage_lib.ioc_clean module

+

Destroy all of a dataset type.

+
+
+class iocage_lib.ioc_clean.IOCClean(callback=None, silent=False)
+

Bases: object

+

Cleans datasets and snapshots of a given type.

+
+
+clean_all()
+

Cleans everything related to iocage.

+
+ +
+
+clean_debug()
+

Removes the debug directory

+
+ +
+
+clean_images()
+

Destroys the images dataset

+
+ +
+
+clean_jails()
+

Cleans all jails and their respective snapshots.

+
+ +
+
+clean_releases()
+

Cleans all releases and the jails created from them.

+
+ +
+
+clean_templates()
+

Cleans all templates and their respective children.

+
+ +
+ +
+
+

iocage_lib.ioc_common module

+

Common methods we reuse.

+
+
+iocage_lib.ioc_common.boolean_prop_exists(supplied_props, props_to_check)
+
+ +
+
+iocage_lib.ioc_common.callback(_log, callback_exception)
+

Helper to call the appropriate logging level

+
+ +
+
+iocage_lib.ioc_common.check_release_newer(release, callback=None, silent=False, raise_error=True, major_only=False)
+

Checks if the host RELEASE is greater than the target release

+
+ +
+
+iocage_lib.ioc_common.check_truthy(value)
+

Checks if the given value is ‘True’

+
+ +
+
+iocage_lib.ioc_common.checkoutput(*args, **kwargs)
+

Just a wrapper to return utf-8 from check_output

+
+ +
+
+iocage_lib.ioc_common.construct_truthy(item, inverse=False)
+

Will return an iterable with all truthy variations

+
+ +
+
+iocage_lib.ioc_common.consume_and_log(exec_gen, log=True, callback=None)
+

Consume a generator and massage the output with lines

+
+ +
+
+iocage_lib.ioc_common.copytree(src, dst, symlinks=False, ignore=None)
+

Copies a tree and overwrites.

+
+ +
+
+iocage_lib.ioc_common.gen_nat_ip(ip_prefix)
+

Best effort to try to allocate a private NAT IP for a jail

+
+ +
+
+iocage_lib.ioc_common.gen_unused_lo_ip()
+

Best effort to try to allocate a localhost IP for a jail

+
+ +
+
+iocage_lib.ioc_common.generate_devfs_ruleset(conf, paths=None, includes=None, callback=None, silent=False)
+

Will add a per jail devfs ruleset with the specified rules, +specifying defaults that equal devfs_ruleset 4

+
+ +
+
+iocage_lib.ioc_common.get_active_jails()
+
+ +
+
+iocage_lib.ioc_common.get_host_gateways()
+
+ +
+
+iocage_lib.ioc_common.get_host_release()
+

Helper to return the hosts sanitized RELEASE

+
+ +
+
+iocage_lib.ioc_common.get_jail_freebsd_version(path, release)
+

Checks the current patch level for the jail

+
+ +
+
+iocage_lib.ioc_common.get_jails_with_config(filters=None, mapping_func=None)
+
+ +
+
+iocage_lib.ioc_common.get_name_sortkey(name)
+
+ +
+
+iocage_lib.ioc_common.get_natural_sortkey(text)
+
+ +
+
+iocage_lib.ioc_common.get_nested_key(_dict, keys=None)
+

Gets a nested key from a dictionary.

+
+ +
+
+iocage_lib.ioc_common.get_size_sortkey(size)
+
+ +
+
+iocage_lib.ioc_common.get_used_ips()
+

Run ifconfig in every jail and return an iteratable of the inuse addresses

+
+ +
+
+iocage_lib.ioc_common.ioc_sort(caller, s_type, data=None)
+
+ +
+
+iocage_lib.ioc_common.logit(content, _callback=None, silent=False, exception=<class 'RuntimeError'>)
+

Helper to check callable status of callback or call ours.

+
+ +
+
+iocage_lib.ioc_common.lowercase_set(values)
+
+ +
+
+iocage_lib.ioc_common.match_to_dir(iocroot, uuid, old_uuid=None)
+

Checks for existence of jail/template with specified uuid. +Replaces dots and underscores in the uuid with pattern [._] and returns +the template- or jail directory that matches, or returns None if no match +was found. +Background: jail(8) doesn’t allow dots in the name, they will be replaced +with underscores. Because of this, foo.bar and foo_bar will be considered +identical, as they cannot coexist.

+
+ +
+
+iocage_lib.ioc_common.open_atomic(filepath, *args, **kwargs)
+

Open temporary file object that atomically moves to destination upon +exiting.

+

Allows reading and writing to and from the same filename.

+

The file will not be moved to destination in case of an exception.

+
+

Parameters

+
+
filepathstring

the file path to be opened

+
+
fsyncbool

whether to force write the file to disk

+
+
*argsmixed

Any valid arguments for open

+
+
**kwargsmixed

Any valid keyword arguments for open

+
+
+
+
+ +
+
+iocage_lib.ioc_common.parse_latest_release()
+

Returns the latest RELEASE from upstreams supported list

+
+ +
+
+iocage_lib.ioc_common.parse_package_name(pkg)
+
+ +
+
+iocage_lib.ioc_common.raise_sort_error(sort_list)
+
+ +
+
+iocage_lib.ioc_common.retrieve_admin_portals(conf, jail_running, admin_portal, default_gateways=None, full_ipv4_dict=None)
+
+ +
+
+iocage_lib.ioc_common.retrieve_ip4_for_jail(conf, jail_running)
+
+ +
+
+iocage_lib.ioc_common.runscript(script, custom_env=None)
+

Runs the script provided and return a tuple with first value showing +stdout and last showing stderr

+
+ +
+
+iocage_lib.ioc_common.set_interactive(interactive)
+

Returns True or False if stdout is a tty

+
+ +
+
+iocage_lib.ioc_common.set_rcconf(jail_path, key, value)
+
+ +
+
+iocage_lib.ioc_common.sort_ava(ava)
+

Sort df by AVA

+
+ +
+
+iocage_lib.ioc_common.sort_boot(boot)
+

Sort the list by boot, then by name.

+
+ +
+
+iocage_lib.ioc_common.sort_created(crt)
+

Sort snaplist by CREATED

+
+ +
+
+iocage_lib.ioc_common.sort_crt(crt)
+

Sort df by CRT

+
+ +
+
+iocage_lib.ioc_common.sort_ip(sort_row, version='4')
+

Sort the list by IP address +We expect the following values for ip sorting +1) interface|ip/subnet +2) interface|ip +3) interface|dhcp +4) ip +5) ip|accept_rtadv

+

All the while obviously not forgetting that there can be multiple +ips specified by ‘,’ delimiter

+
+ +
+
+iocage_lib.ioc_common.sort_ip6(ip)
+

Helper for sort_ip

+
+ +
+
+iocage_lib.ioc_common.sort_jid(jid)
+

Sort the list by JID.

+
+ +
+
+iocage_lib.ioc_common.sort_key(item)
+

Sort list by the first key.

+
+ +
+
+iocage_lib.ioc_common.sort_name(name)
+

Sort list by the name.

+
+ +
+
+iocage_lib.ioc_common.sort_qta(qta)
+

Sort df by QTA or snaplist by USED

+
+ +
+
+iocage_lib.ioc_common.sort_release(releases, split=False, fetch_releases=False)
+

Sort the list by RELEASE, if split is true it’s expecting full +datasets.

+
+ +
+
+iocage_lib.ioc_common.sort_res(res)
+

Sort df by RES or snaplist by RSIZE

+
+ +
+
+iocage_lib.ioc_common.sort_state(state)
+

Sort the list by state, then by name.

+
+ +
+
+iocage_lib.ioc_common.sort_template(template)
+

Helper function for templates to be sorted in sort_name

+
+ +
+
+iocage_lib.ioc_common.sort_type(jail_type)
+

Sort the list by jail type, then by name.

+
+ +
+
+iocage_lib.ioc_common.sort_use(use)
+

Sort df by USE

+
+ +
+
+iocage_lib.ioc_common.tempfile(suffix='', dir=None)
+

Context for temporary file.

+

Will find a free temporary filename upon entering +and will try to delete the file on leaving, even in case of an exception.

+
+

Parameters

+
+
suffixstring

optional file suffix

+
+
dirstring

optional directory to save temporary file in

+
+
+
+
+ +
+
+iocage_lib.ioc_common.tmp_dataset_checks(_callback, silent)
+
+ +
+
+iocage_lib.ioc_common.truthy_inverse_values()
+
+ +
+
+iocage_lib.ioc_common.truthy_values()
+
+ +
+
+iocage_lib.ioc_common.try_convert(value, default, *types)
+
+ +
+
+iocage_lib.ioc_common.validate_plugin_manifest(manifest, _callback, silent)
+
+ +
+
+

iocage_lib.ioc_create module

+

iocage create module.

+
+
+class iocage_lib.ioc_create.IOCCreate(release, props, num, pkglist=None, plugin=False, migrate=False, config=None, silent=False, template=False, short=False, basejail=False, thickjail=False, empty=False, uuid=None, clone=False, thickconfig=False, clone_basejail=False, callback=None)
+

Bases: object

+

Create a jail from a clone.

+
+
+create_config(jail_uuid, release, source_template)
+

Create the jail configuration with the minimal needed defaults. +If self.thickconfig is True, it will create a jail with all properties.

+
+ +
+
+create_install_packages(jail_uuid, location, repo='pkg.freebsd.org')
+

Takes a list of pkg’s to install into the target jail. The resolver +property is required for pkg to have network access.

+
+ +
+
+create_jail()
+

Helper to catch SIGINT

+
+ +
+
+create_rc(location, host_hostname, basejail=0)
+
+
Writes a boilerplate rc.conf file for a jail if it doesn’t exist,

otherwise changes the hostname.

+
+
+
+ +
+
+create_thickjail(jail_uuid, source)
+
+ +
+ +
+
+

iocage_lib.ioc_debug module

+

This collects debug about all the iocage jails.

+
+
+class iocage_lib.ioc_debug.IOCDebug(path, silent=False, callback=None)
+

Bases: object

+
+
Collects the following debug for a system + jails/templates:

zfs list +mount +df -h

+

iocage get all +/etc/hosts +/etc/rc.conf +/etc/nsswitch.conf +ifconfig -a +netstat -nr +/etc/resolv.conf

+
+
+
+
+run_debug()
+
+ +
+
+run_host_debug()
+
+ +
+
+run_jail_debug(name, path)
+
+ +
+ +
+
+

iocage_lib.ioc_destroy module

+

iocage destroy module.

+
+
+class iocage_lib.ioc_destroy.IOCDestroy(callback=None)
+

Bases: object

+

Destroy a jail’s datasets and then if they have a RELEASE snapshot, +destroy that as well.

+
+
+destroy_jail(path, clean=False)
+
+
A convenience wrapper to call __stop_jails__ and

__destroy_parse_datasets__

+
+
+
+ +
+ +
+
+

iocage_lib.ioc_exceptions module

+

Exception classes for iocage

+
+
+exception iocage_lib.ioc_exceptions.CommandFailed(message)
+

Bases: ExceptionWithMsg

+
+ +
+
+exception iocage_lib.ioc_exceptions.CommandNeedsRoot(message)
+

Bases: ExceptionWithMsg

+
+ +
+
+exception iocage_lib.ioc_exceptions.ExceptionWithMsg(message)
+

Bases: Exception

+

message attribute will be an iterable if a message is supplied

+
+ +
+
+exception iocage_lib.ioc_exceptions.Exists(message)
+

Bases: ExceptionWithMsg

+
+ +
+
+exception iocage_lib.ioc_exceptions.JailCorruptConfiguration(message)
+

Bases: JailMisconfigured

+
+ +
+
+exception iocage_lib.ioc_exceptions.JailMisconfigured(message)
+

Bases: ExceptionWithMsg

+
+ +
+
+exception iocage_lib.ioc_exceptions.JailMissingConfiguration(message)
+

Bases: JailMisconfigured

+
+ +
+
+exception iocage_lib.ioc_exceptions.JailRunning
+

Bases: Exception

+
+ +
+
+exception iocage_lib.ioc_exceptions.PoolNotActivated
+

Bases: Exception

+
+ +
+
+exception iocage_lib.ioc_exceptions.ValidationFailed(message)
+

Bases: ExceptionWithMsg

+
+ +
+
+exception iocage_lib.ioc_exceptions.ValueNotFound
+

Bases: Exception

+
+ +
+
+iocage_lib.ioc_exceptions.ignore_exceptions(*exceptions, clean=None, suppress_exception=True)
+

Ignore any exceptions specified by exceptions and make sure that +we clean any resources specified by callable clean

+
+ +
+
+

iocage_lib.ioc_exec module

+

iocage exec module.

+
+
+class iocage_lib.ioc_exec.IOCExec(command, path, uuid='', host_user='root', jail_user=None, plugin=False, unjailed=False, skip=False, stdin_bytestring=None, su_env=None, decode=False, callback=None)
+

Bases: object

+

Run jexec with a user inside the specified jail.

+
+
+exec_jail()
+
+ +
+
+flight_checks()
+
+ +
+ +
+
+class iocage_lib.ioc_exec.InteractiveExec(*args, **kwargs)
+

Bases: IOCExec

+
+ +
+
+class iocage_lib.ioc_exec.SilentExec(*args, **kwargs)
+

Bases: object

+
+ +
+
+

iocage_lib.ioc_fetch module

+

iocage fetch module.

+
+
+class iocage_lib.ioc_fetch.IOCFetch(release, server='download.freebsd.org', user='anonymous', password='anonymous@', auth=None, root_dir=None, http=True, _file=False, verify=True, hardened=False, update=True, eol=True, files=('MANIFEST', 'base.txz', 'lib32.txz', 'src.txz'), silent=False, callback=None)
+

Bases: object

+

Fetch a RELEASE for use as a jail base.

+
+
+fetch_download(_list, missing=False)
+

Creates the download dataset and then downloads the RELEASE.

+
+ +
+
+fetch_extract(f)
+

Takes a src and dest then creates the RELEASE dataset for the data.

+
+ +
+
+fetch_http_release(eol, _list=False)
+

Fetch a user specified RELEASE from FreeBSD’s http server or a user +supplied one. The user can also specify the user, password and +root-directory containing the release tree that looks like so:

+
+
    +

  • XX.X-RELEASE

    • +

  • XX.X-RELEASE

    • +

  • XX.X-RELEASE

    • +
+
+
+ +
+
+fetch_release(_list=False)
+

Small wrapper to choose the right fetch.

+
+ +
+
+fetch_update(cli=False, uuid=None)
+

This calls ‘freebsd-update’ to update the fetched RELEASE.

+
+ +
+
+update_progress(progress, display_text, elapsed, chunk_size)
+

Displays or updates a console progress bar. +Original source: https://stackoverflow.com/a/15860757/1391441

+
+ +
+ +
+
+

iocage_lib.ioc_fstab module

+

Manipulate a jails fstab

+
+
+class iocage_lib.ioc_fstab.Fstab
+

Bases: Structure

+
+
+fs_file
+

Structure/Union member

+
+ +
+
+fs_freq
+

Structure/Union member

+
+ +
+
+fs_mntops
+

Structure/Union member

+
+ +
+
+fs_passno
+

Structure/Union member

+
+ +
+
+fs_spec
+

Structure/Union member

+
+ +
+
+fs_type
+

Structure/Union member

+
+ +
+
+fs_vfstype
+

Structure/Union member

+
+ +
+ +
+
+class iocage_lib.ioc_fstab.IOCFstab(uuid, action, source='', destination='', fstype='', fsoptions='', fsdump='', fspass='', index=None, silent=False, callback=None, header=False)
+

Bases: object

+

Will add or remove an entry, and mount or umount the filesystem.

+
+
+fstab_list()
+

Returns list of lists, or a table

+
+ +
+ +
+
+

iocage_lib.ioc_image module

+

iocage export and import module

+
+
+class iocage_lib.ioc_image.IOCImage(callback=None, silent=False)
+

Bases: object

+

export() and import()

+
+
+export_jail(uuid, path, compression_algo='zip')
+

Make a recursive snapshot of the jail and export to a file.

+
+ +
+
+import_jail(jail, compression_algo=None, path=None)
+

Import from an iocage export.

+
+ +
+ +
+
+

iocage_lib.ioc_json module

+

Convert, load or write JSON.

+
+
+class iocage_lib.ioc_json.IOCConfiguration(location, checking_datasets, silent, callback)
+

Bases: object

+
+
+backup_iocage_jail_conf(location)
+
+ +
+
+check_config(conf, default=False)
+

Takes JSON as input and checks to see what is missing and adds the +new keys to the defaults with their default values if missing.

+
+ +
+
+check_default_config()
+

This sets up the default configuration for jails.

+
+ +
+
+check_jail_config(conf)
+

Checks the jails configuration and migrates anything needed

+
+ +
+
+fix_properties(conf)
+

Takes a conf file and makes sure any property that has a bad value +that was previously allowed is fixed to the correct equivalent, but +aren’t a CONFIG_VERSION bump

+

Returns a bool if it updated anything and it needs writing

+
+ +
+
+static get_mac_prefix()
+
+ +
+
+get_pool_and_iocroot()
+

For internal getting of pool and iocroot.

+
+ +
+
+static get_version()
+

Sets the iocage configuration version.

+
+ +
+
+json_write(data, _file='/config.json', defaults=False)
+

Write a JSON file at the location given with supplied data.

+
+ +
+
+static retrieve_default_props()
+
+ +
+
+static validate_mac_prefix(mac_prefix)
+
+ +
+ +
+
+class iocage_lib.ioc_json.IOCCpuset(name)
+

Bases: object

+
+
+static retrieve_cpu_sets()
+
+ +
+
+set_cpuset(value=None)
+
+ +
+
+static validate_cpuset_prop(value, raise_error=True)
+
+ +
+ +
+
+class iocage_lib.ioc_json.IOCJson(location='', silent=False, cli=False, stop=False, checking_datasets=False, suppress_log=False, callback=None)
+

Bases: IOCConfiguration

+

Migrates old iocage configurations(UCL and ZFS Props) to the new JSON +format, will set and get properties.

+
+
+default_only_props = ['nat_prefix', 'nat_interface', 'nat_backend']
+
+ +
+
+get_full_config()
+
+ +
+
+json_check_prop(key, value, conf, default=False)
+

Checks if the property matches known good values, if it’s the +CLI, deny setting any properties not in this list.

+
+ +
+
+json_convert_from_ucl()
+

Convert to JSON. Accepts a location to the ucl configuration.

+
+ +
+
+json_convert_from_zfs(uuid, skip=False)
+

Convert to JSON. Accepts a jail UUID

+
+ +
+
+json_get_value(prop, default=False)
+

Returns a string with the specified prop’s value.

+
+ +
+
+json_load()
+

Load the JSON at the location given. Returns a JSON object.

+
+ +
+
+json_migrate_uuid_to_tag(uuid, tag, state, conf)
+

This will migrate an old uuid + tag jail to a tag only one

+
+ +
+
+json_plugin_get_value(prop)
+
+ +
+
+json_plugin_load()
+
+ +
+
+json_plugin_set_value(prop)
+
+ +
+
+json_set_value(prop, _import=False, default=False)
+

Set a property for the specified jail.

+
+ +
+
+truthy_props = ['bpf', 'template', 'host_time', 'basejail', 'dhcp', 'vnet', 'rtsold', 'jail_zfs', 'hostid_strict_check', 'boot', 'exec_clean', 'mount_linprocfs', 'mount_procfs', 'allow_vmm', 'allow_tun', 'allow_socket_af', 'allow_quotas', 'allow_mount_zfs', 'allow_mount_tmpfs', 'allow_mount_procfs', 'allow_mount_nullfs', 'allow_mount_fusefs', 'allow_mount_devfs', 'allow_mount_fdescfs', 'allow_mount_linprocfs', 'allow_mount_linsysfs', 'allow_mount', 'allow_mlock', 'allow_chflags', 'allow_raw_sockets', 'allow_sysvipc', 'allow_set_hostname', 'allow_nfsd', 'mount_fdescfs', 'mount_devfs', 'ip6_saddrsel', 'ip4_saddrsel', 'ip_hostname', 'assign_localhost', 'nat']
+
+ +
+ +
+
+class iocage_lib.ioc_json.IOCRCTL(name)
+

Bases: object

+
+
+rctl_rules_exist(prop=None)
+
+ +
+
+remove_rctl_rules(props=None)
+
+ +
+
+set_rctl_rules(props)
+
+ +
+
+types = {'coredumpsize', 'cputime', 'datasize', 'maxproc', 'memorylocked', 'memoryuse', 'msgqqueued', 'msgqsize', 'nmsgq', 'nsem', 'nsemop', 'nshm', 'nthr', 'openfiles', 'pcpu', 'pseudoterminals', 'readbps', 'readiops', 'shmsize', 'stacksize', 'swapuse', 'vmemoryuse', 'wallclock', 'writebps', 'writeiops'}
+
+ +
+
+static validate_rctl_props(prop, value)
+
+ +
+
+static validate_rctl_tunable()
+
+ +
+ +
+
+class iocage_lib.ioc_json.JailRuntimeConfiguration(jail_name, data=None)
+

Bases: object

+
+
+normalize_data(data)
+
+ +
+
+property path
+
+ +
+
+remove(key)
+
+ +
+
+set(key, value=None)
+
+ +
+
+sync_changes()
+
+ +
+ +
+
+

iocage_lib.ioc_list module

+

List all datasets by type

+
+
+class iocage_lib.ioc_list.IOCList(lst_type='all', hdr=True, full=False, _sort=None, silent=False, callback=None, plugin=False, quick=False, **kwargs)
+

Bases: object

+

List jails that are a specified type.

+
+
Format is:

JID UID BOOT STATE TYPE IP4 RELEASE

+
+
+
+
+list_all(jails)
+

List all jails.

+
+ +
+
+list_all_quick(jails)
+

Returns a table of jails with minimal processing

+
+ +
+
+list_bases(datasets)
+

Lists all bases.

+
+ +
+
+list_datasets()
+

Lists the datasets of given type.

+
+ +
+
+classmethod list_get_jid(uuid)
+

Return a tuple containing True or False and the jail’s id or ‘-‘.

+
+ +
+ +
+
+

iocage_lib.ioc_plugin module

+

iocage plugin module

+
+
+class iocage_lib.ioc_plugin.IOCPlugin(release=None, jail=None, plugin=None, branch=None, keep_jail_on_failure=False, callback=None, silent=False, **kwargs)
+

Bases: object

+

This is responsible for the general life cycle of a plugin jail. This +includes creation, updating and upgrading.

+
+
+DEFAULT_PROPS = {'boot': 1, 'vnet': 1}
+
+ +
+
+PLUGIN_VERSION = '2'
+
+ +
+
+static expand_abi_with_specified_release(packagesite, release)
+
+ +
+
+fetch_plugin(props, num, accept_license)
+

Helper to fetch plugins

+
+ +
+
+fetch_plugin_index(props, _list=False, list_header=False, list_long=False, accept_license=False, icon=False, official=False, index_only=False)
+
+ +
+
+static fetch_plugin_packagesites(package_sites)
+
+ +
+
+fetch_plugin_versions()
+
+ +
+
+static fetch_plugin_versions_from_plugin_index(plugins_index)
+
+ +
+
+pull_clone_git_repo(depth=None)
+
+ +
+
+static retrieve_plugin_index_data(plugin_index_path, expand_abi=True)
+
+ +
+
+retrieve_plugin_json()
+
+ +
+
+start_rc()
+
+ +
+
+stop_rc()
+
+ +
+
+update(jid)
+
+ +
+
+upgrade(jid)
+
+ +
+ +
+
+

iocage_lib.ioc_start module

+

This is responsible for starting jails.

+
+
+class iocage_lib.ioc_start.IOCStart(uuid, path, silent=False, callback=None, is_depend=False, unit_test=False, suppress_exception=False, used_ports=None)
+

Bases: object

+

Starts jails, the network stack for the jail and generates a resolv file

+

for them. It also finds any scripts the user supplies for exec_*

+
+
+check_aliases(ip_addrs, mode='4')
+

Check if the alias already exists for given IP’s, otherwise add +default interface to the ips and return the new list

+
+ +
+
+find_bridge_mtu(bridge)
+
+ +
+
+get_bridge_members(bridge)
+
+ +
+
+get_default_gateway(address_family='ipv4')
+
+ +
+
+get_default_interface()
+
+ +
+
+start_copy_localtime()
+
+ +
+
+start_generate_resolv()
+
+ +
+
+start_network(vnet, nat=False)
+

This function is largely a check to see if VNET is true, and then to +actually run the correct function, otherwise it passes.

+
+
Parameters:
+

vnet – Boolean

+
+
+
+ +
+
+start_network_interface_vnet(nic_defs, net_configs, jid, nat_addr=0)
+

Start VNET on interface

+
+
Parameters:
+
    +

  • nic_defs – comma separated interface definitions (nic, bridge)

    • +

  • net_configs – Tuple of IP address and router pairs

    • +

  • jid – The jails ID

    • +
+
+
+
+ +
+
+start_network_vnet_addr(iface, ip, defaultgw, ipv6=False)
+

Add an IP address to a vnet interface inside the jail.

+
+
Parameters:
+
    +

  • iface – The interface to use

    • +

  • ip – The IP address to assign

    • +

  • defaultgw – The gateway IP to assign to the nic

    • +
+
+
Returns:
+

If an error occurs it returns the error. Otherwise, it’s None

+
+
+
+ +
+
+start_network_vnet_iface(nic, bridge, mtu, jid, nat_addr=0)
+

The real meat and potatoes for starting a VNET interface.

+
+
Parameters:
+
    +

  • nic – The network interface to assign the IP in the jail

    • +

  • bridge – The bridge to attach the VNET interface

    • +

  • mtu – The mtu of the VNET interface

    • +

  • jid – The jails ID

    • +
+
+
Returns:
+

If an error occurs it returns the error. Otherwise, it’s None

+
+
+
+ +
+ +
+
+

iocage_lib.ioc_stop module

+

This stops jails.

+
+
+class iocage_lib.ioc_stop.IOCStop(uuid, path, silent=False, callback=None, force=False, suppress_exception=False)
+

Bases: object

+

Stops a jail and unmounts the jails mountpoints.

+
+ +
+
+

iocage_lib.ioc_upgrade module

+

iocage upgrade module

+
+
+class iocage_lib.ioc_upgrade.IOCUpgrade(new_release, path, interactive=True, silent=False, callback=None)
+

Bases: object

+

Will upgrade a jail to the specified RELEASE.

+
+
+upgrade_basejail(snapshot=True, snap_name=None)
+
+ +
+
+upgrade_jail()
+
+ +
+ +
+
+

iocage_lib.iocage module

+
+
+class iocage_lib.iocage.IOCage(jail=None, rc=False, callback=None, silent=False, activate=False, skip_jails=False, reset_cache=False)
+

Bases: object

+
+
+activate(zpool)
+

Activates the zpool for iocage usage

+
+ +
+
+chroot(command)
+

Deprecated: Chroots into a jail and runs a command, or the shell.

+
+ +
+
+clean(d_type)
+

Destroys all of a specified dataset types.

+
+ +
+
+create(release, props, count=0, pkglist=None, template=False, short=False, _uuid=None, basejail=False, thickjail=False, empty=False, clone=None, skip_batch=False, thickconfig=False, clone_basejail=False)
+

Creates the jail dataset

+
+ +
+
+deactivate(zpool)
+
+ +
+
+debug(directory)
+
+ +
+
+destroy_jail(force=False)
+

Destroys the supplied jail, to reduce perfomance hit, +call IOCage with skip_jails=True

+
+ +
+
+destroy_release(download=False)
+

Destroy supplied RELEASE and the download dataset if asked

+
+ +
+
+df()
+

Returns a list containing the resource usage of all jails

+
+ +
+
+exec(command, host_user='root', jail_user=None, console=False, start_jail=False, interactive=False, unjailed=False, msg_return=False)
+

Executes a command in the jail as the supplied users.

+
+ +
+
+exec_all(command, host_user='root', jail_user=None, console=False, start_jail=False, interactive=False, unjailed=False, msg_return=False)
+

Runs exec for all jails

+
+ +
+
+export(compression_algo='zip')
+

Will export a jail

+
+ +
+
+fetch(**kwargs)
+

Fetches a release or plugin.

+
+ +
+
+fstab(action, source, destination, fstype, options, dump, _pass, index=None, add_path=False, header=False)
+

Adds an fstab entry for a jail

+
+ +
+
+get(prop, recursive=False, plugin=False, pool=False, start_jail=False)
+

Get a jail property

+
+ +
+
+import_(compression_algo='zip', path=None)
+

Imports a jail

+
+ +
+
+list(lst_type, header=False, long=False, sort='name', uuid=None, plugin=False, quick=False, **kwargs)
+

Returns a list of lst_type

+
+ +
+
+rename(new_name)
+
+ +
+
+static reset_cache()
+
+ +
+
+restart(soft=False)
+
+ +
+
+rollback(name)
+

Rolls back a jail and all datasets to the supplied snapshot

+
+ +
+
+set(prop, plugin=False, rename=False)
+

Sets a property for a jail or plugin

+
+ +
+
+snap_list(long=True, _sort='created')
+

Gathers a list of snapshots and returns it

+
+ +
+
+snap_remove(snapshot)
+

Removes user supplied snapshot from jail

+
+ +
+
+snapshot(name)
+

Will create a snapshot for the given jail

+
+ +
+
+start(jail=None, ignore_exception=False, used_ports=None)
+

Checks jails type and existence, then starts the jail

+
+ +
+
+stop(jail=None, force=False, ignore_exception=False)
+

Stops the jail.

+
+ +
+
+update(pkgs=False)
+

Updates a jail to the latest patchset.

+
+ +
+
+update_all(pkgs=False)
+

Runs update for all jails

+
+ +
+
+upgrade(release)
+
+ +
+
+upgrade_all(release)
+

Runs upgrade for all jails

+
+ +
+ +
+
+class iocage_lib.iocage.PoolAndDataset
+

Bases: object

+
+
+get_iocroot()
+

Helper to get the iocroot.

+
+
Return:

string: with the iocroot name.

+
+
+
+ +
+
+get_pool()
+

Helper to get the current pool.

+
+
Return:

string: with the pool name.

+
+
+
+ +
+ +
+
+

Module contents

+
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/doc/build/html/jailtypes.html b/docs/jailtypes.html similarity index 100% rename from doc/build/html/jailtypes.html rename to docs/jailtypes.html diff --git a/doc/build/html/known-issues.html b/docs/known-issues.html similarity index 100% rename from doc/build/html/known-issues.html rename to docs/known-issues.html diff --git a/docs/modules.html b/docs/modules.html new file mode 100644 index 00000000..da637941 --- /dev/null +++ b/docs/modules.html @@ -0,0 +1,513 @@ + + + + + + + + + iocage — iocage 1.9 documentation + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

iocage

+
+ +
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/doc/build/html/networking.html b/docs/networking.html similarity index 100% rename from doc/build/html/networking.html rename to docs/networking.html diff --git a/doc/build/html/objects.inv b/docs/objects.inv similarity index 100% rename from doc/build/html/objects.inv rename to docs/objects.inv diff --git a/docs/plugins.html b/docs/plugins.html new file mode 100644 index 00000000..d79262fb --- /dev/null +++ b/docs/plugins.html @@ -0,0 +1,209 @@ + + + + + + + + + Plugins — iocage 1.9 documentation + + + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

Plugins

+

iocage plugins are a simple and very fast method to get application +containers installed and configured. At its core, a plugin is a jail +specifically running one program. Popular programs can be installed +repeatedly with one line. Additionally, plugins are easily extended by +users, offering a high level of customizability and functionality.

+

In structure, a plugin consists of .json manifest and +.png icon files.

+

See what’s available

+

To see a list of all currently available plugins, open a command line +and type iocage list -PR or +iocage list --plugins --remote. The full +iocage plugin list +is also available on GitHub.

+

Check which plugins are installed on the system with +iocage list --plugins or iocage list -P.

+

Getting started with plugins

+
+

Note

+

iocage needs to be activated before +plugins can be installed or modified!

+
+

To get started, open a command line and type +iocage fetch --plugins ip4_addr="IF|IP". This initial +fetch also supports dhcp in the same manner as +iocage create. The IP listed for the plugin needs to +be a valid IP not already in use. Use the - -name flag to easily fetch a +specific plugin:

+

$ iocage fetch --plugins --name plexmediaserver ip4_addr="igb0|192.168.0.91"

+

If available, plugins can also be fetched locally with +iocage fetch -P the/path/to/plugin.json ip4_addr="re0|192.168.0.100"

+
+

Tip

+

Using iocage fetch locally is very useful when +testing an in-development plugin.

+
+

After fetching a plugin, view of all its properties with +iocage get -a NAME|UUID | less. Individual properties are +found with iocage get PROPERTY:

+

$ iocage get type quasselcore

+

Adjust the plugin properties with iocage set:

+

$ iocage set PROPERTY quasselcore

+

iocage set is used to configure +that plugin. In this example, a complete Quasselcore plugin is +installed to a FreeNAS system, then the note of the plugin is changed:

+
[root@freenas ~]# iocage fetch --plugins --name quasselcore ip4_addr="em0|192.168.1.50"
+[root@freenas ~]# iocage set notes="Hello world" quasselcore
+[root@freenas ~]# iocage get notes quasselcore
+Hello world
+
+
+

Upgrading and updating plugins

+

The process for upgrading and updating plugins is exactly the same as +normal jails. See Updating Jails or Upgrading Jails .

+

Plugin Manifest Example

+

Following is an example of a plugin manifest:

+
{
+    "name": "default_jail_name_here",
+    "release": "11.3-RELEASE",
+    "artifact": "https://github.com/git_path_to_plugin_repo",
+    "official": false,
+    "properties": {
+        "nat": 1,
+        "nat_forwards": "tcp(7878:7878)"
+    },
+    "devfs_ruleset": {
+        "paths": {"bpf*": null},
+        "includes": []
+    },
+    "pkgs": [
+    ],
+    "packagesite": "http://pkg.FreeBSD.org/${ABI}/latest",
+    "fingerprints": {
+        "iocage-plugins": [
+            {
+                "function": "sha256",
+                "fingerprint": "b0170035af3acc5f3f3ae1859dc717101b4e6c1d0a794ad554928ca0cbb2f438"
+            }
+        ]
+    },
+    "revision": 0
+}
+
+
+
    +

  • devfs_ruleset: It should be a valid dictionary object where “paths” must be specified. Value of “paths” is a +dictionary where keys are the path to be added and the value is the mode to be used. null translates to unhide. +For any include specified, please refer to the following example which shows how each path specified is added as +iocage dynamically generates a devfs ruleset and how an include is added to the ruleset:

    • +
+
devfs rule -s ruleset_number add path bpf* unhide
+devfs rule -s ruleset_number add include include_value
+
+
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ previous | + next | + modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/docs/py-modindex.html b/docs/py-modindex.html new file mode 100644 index 00000000..c871c95d --- /dev/null +++ b/docs/py-modindex.html @@ -0,0 +1,373 @@ + + + + + + + + Python Module Index — iocage 1.9 documentation + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
+ + +

Python Module Index

+ +
+ f | + i +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 
+ f
+ fastentrypoints +
 
+ i
+ iocage_cli +
    + iocage_cli.activate +
    + iocage_cli.chroot +
    + iocage_cli.clean +
    + iocage_cli.clone +
    + iocage_cli.console +
    + iocage_cli.create +
    + iocage_cli.debug +
    + iocage_cli.destroy +
    + iocage_cli.df +
    + iocage_cli.exec +
    + iocage_cli.export +
    + iocage_cli.fetch +
    + iocage_cli.fstab +
    + iocage_cli.get +
    + iocage_cli.import +
    + iocage_cli.list +
    + iocage_cli.migrate +
    + iocage_cli.pkg +
    + iocage_cli.rename +
    + iocage_cli.restart +
    + iocage_cli.rollback +
    + iocage_cli.set +
    + iocage_cli.snaplist +
    + iocage_cli.snapremove +
    + iocage_cli.snapshot +
    + iocage_cli.start +
    + iocage_cli.stop +
    + iocage_cli.update +
    + iocage_cli.upgrade +
+ iocage_lib +
    + iocage_lib.ioc_check +
    + iocage_lib.ioc_clean +
    + iocage_lib.ioc_common +
    + iocage_lib.ioc_create +
    + iocage_lib.ioc_debug +
    + iocage_lib.ioc_destroy +
    + iocage_lib.ioc_exceptions +
    + iocage_lib.ioc_exec +
    + iocage_lib.ioc_fetch +
    + iocage_lib.ioc_fstab +
    + iocage_lib.ioc_image +
    + iocage_lib.ioc_json +
    + iocage_lib.ioc_list +
    + iocage_lib.ioc_plugin +
    + iocage_lib.ioc_start +
    + iocage_lib.ioc_stop +
    + iocage_lib.ioc_upgrade +
    + iocage_lib.iocage +
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/doc/build/html/search.html b/docs/search.html similarity index 100% rename from doc/build/html/search.html rename to docs/search.html diff --git a/doc/build/html/searchindex.js b/docs/searchindex.js similarity index 60% rename from doc/build/html/searchindex.js rename to docs/searchindex.js index d4f49191..3d265f0d 100644 --- a/doc/build/html/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["advanced-use", "basic-use", "best-practices", "debian", "faq", "fastentrypoints", "index", "install", "iocage_cli", "iocage_lib", "jailtypes", "known-issues", "modules", "networking", "plugins", "setup", "templates", "tests"], "filenames": ["advanced-use.rst", "basic-use.rst", "best-practices.rst", "debian.rst", "faq.rst", "fastentrypoints.rst", "index.rst", "install.rst", "iocage_cli.rst", "iocage_lib.rst", "jailtypes.rst", "known-issues.rst", "modules.rst", "networking.rst", "plugins.rst", "setup.rst", "templates.rst", "tests.rst"], "titles": ["Advanced Usage", "Basic Usage", "Best Practices", "Create a Debian Buster Jail (native Linux)", "FAQ", "fastentrypoints module", "iocage - A FreeBSD Jail Manager", "Install iocage", "iocage_cli package", "iocage_lib package", "Jail Types", "Known Issues", "iocage", "Networking", "Plugins", "setup module", "Using Templates", "tests package"], "terms": {"when": [0, 1, 2, 7, 11, 13, 14], "i": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 16], "iocag": [0, 2, 3, 4, 10, 11, 13, 14, 16], "zf": [0, 3, 4, 6, 9, 10, 11], "filesystem": [0, 7, 9], "essenti": [0, 1, 4, 16], "ar": [0, 1, 2, 4, 7, 9, 10, 11, 13, 14, 16], "cheap": 0, "lightweight": 0, "writabl": [0, 4], "A": [0, 1, 4, 9, 13], "its": [0, 14, 16], "sourc": [0, 4, 7, 9], "To": [0, 1, 7, 11, 13, 14, 16], "destroi": [0, 6, 9, 11, 12], "preserv": [0, 10], "must": [0, 4, 7, 13, 14], "first": [0, 1, 9], "www01": [0, 1], "www02": [0, 1], "run": [0, 2, 3, 4, 7, 9, 11, 13, 14], "name": [0, 1, 2, 3, 4, 8, 9, 11, 13, 14, 16], "from": [0, 1, 2, 3, 5, 6, 9, 10, 11, 16], "an": [0, 1, 3, 4, 7, 8, 9, 10, 11, 13, 14], "exist": [0, 1, 7, 8, 9, 12, 16], "snapshotnam": 0, "www03": 0, "thi": [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 13, 14, 16], "function": [0, 1, 9, 11, 14], "isn": [0, 7], "t": [0, 1, 7, 9, 10, 16], "fulli": [0, 4, 10, 13], "ad": [0, 1, 7, 11, 14], "mai": [0, 11], "expect": [0, 9], "uuid": [0, 1, 3, 4, 9, 11, 14, 16], "revers": 0, "relationship": 0, "The": [0, 1, 3, 7, 8, 9, 10, 13, 14, 16], "becom": [0, 4], "demot": 0, "can": [0, 1, 3, 4, 7, 9, 10, 11, 13, 14, 16], "now": [0, 1, 7], "remov": [0, 2, 7, 8, 9, 11, 12], "handl": [0, 13], "freebsd": [0, 1, 4, 7, 9, 11, 13, 14], "8": [0, 1, 3, 4, 6, 9], "util": 0, "while": [0, 9], "thei": [0, 8, 9, 10], "stop": [0, 2, 6, 7, 9, 11, 12, 16], "command": [0, 1, 2, 6, 7, 8, 9, 11, 14], "backup": 0, "given": [0, 1, 8, 9], "manual": [0, 1, 4, 13], "n": [0, 1, 2, 3, 7, 10, 16], "latest": [0, 1, 9, 14], "patch": [0, 1, 5, 9, 10], "level": [0, 8, 9, 14], "finish": [0, 2, 16], "appear": [0, 8], "properli": [0, 11], "snapremov": [0, 12], "test": [0, 1, 2, 3, 8, 10, 12, 13, 14], "without": [0, 11, 13], "affect": [0, 11], "same": [0, 1, 4, 9, 13, 14], "wai": [0, 4, 13], "outlin": 0, "abov": [0, 1, 7, 13], "testupd": 0, "flag": [0, 1, 11, 14], "option": [0, 1, 2, 8, 9, 11, 13], "assign": [0, 1, 4, 9, 11, 13], "By": [0, 1, 13], "default": [0, 1, 2, 4, 6, 7, 9, 13], "user": [0, 1, 2, 4, 9, 10, 11, 13, 14], "suppli": [0, 1, 9], "new": [0, 1, 9, 10, 16], "releas": [0, 2, 3, 6, 9, 10, 11, 13, 14, 16], "": [0, 1, 2, 3, 5, 7, 8, 9, 10, 11, 13, 14, 16], "For": [0, 1, 4, 9, 10, 13, 14], "exampl": [0, 1, 2, 3, 10, 11, 13, 14], "examplejail": [0, 10, 11, 13], "r": [0, 1, 2, 10, 13, 16], "11": [0, 1, 2, 7, 10, 13, 14, 16], "0": [0, 1, 2, 3, 7, 8, 9, 10, 11, 13, 14, 16], "tell": [0, 11], "It": [0, 2, 6, 7, 9, 10, 13, 14, 16], "recommend": [0, 2, 3, 16], "keep": 0, "host": [0, 2, 3, 4, 6, 7, 9, 10, 13], "synchron": [0, 10], "1": [0, 1, 3, 7, 9, 11, 13, 14], "method": [0, 7, 9, 14, 16], "also": [0, 1, 2, 3, 9, 13, 14], "basejail": [0, 1, 6, 7, 9], "make": [0, 4, 7, 9, 16], "sure": [0, 1, 4, 7, 9, 11, 13], "iocage_en": 0, "ye": [0, 2, 3, 4, 10, 16], "set": [0, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 16], "etc": [0, 2, 3, 7, 9, 11, 13], "rc": [0, 2, 9, 13], "conf": [0, 2, 9, 11, 13], "enabl": [0, 1, 3, 4, 11, 13], "dure": 0, "system": [0, 1, 4, 6, 7, 9, 11, 13, 14], "simpli": 0, "creation": [0, 1, 2, 9, 10, 11], "start": [0, 2, 3, 6, 9, 11, 12, 13, 14, 16], "after": [0, 1, 10, 13, 14], "order": [0, 8, 13], "specifi": [0, 1, 8, 9, 13, 14], "valu": [0, 1, 7, 8, 9, 14], "20": 0, "lower": 0, "higher": 0, "requir": [0, 1, 9, 10, 13, 16], "other": [0, 1, 7, 11, 13], "befor": [0, 1, 7, 9, 14], "one": [0, 1, 7, 9, 14], "space": [0, 10], "delimit": [0, 9], "wait": 0, "those": 0, "have": [0, 1, 9, 10, 13], "foo": [0, 9], "bar": [0, 9], "baz": 0, "support": [0, 4, 9, 10, 11, 13, 14], "transpar": [0, 6, 13], "out": [0, 4], "box": 0, "point": [0, 5], "time": [0, 1, 4, 10, 13, 16], "copi": [0, 4, 9, 10], "data": [0, 2, 9, 10], "safeti": 0, "which": [0, 1, 2, 13, 14, 16], "revert": 0, "ani": [0, 1, 7, 8, 9, 14, 16], "initi": [0, 1, 14], "take": [0, 8, 9, 11], "up": [0, 3, 7, 9, 13, 16], "almost": [0, 3], "chang": [0, 1, 2, 7, 9, 10, 14, 16], "record": [0, 8], "snaplist": [0, 9, 12], "base": [0, 1, 6, 8, 9, 10, 13, 16], "current": [0, 1, 7, 9, 11, 14], "avail": [0, 1, 11, 13, 14, 16], "version": [0, 4, 7, 8, 9], "yet": 0, "implement": [0, 8], "all": [0, 7, 9, 10, 14, 16], "subsect": 0, "procedur": 0, "here": [0, 1], "meant": [0, 1], "provid": [0, 1, 2, 9, 11], "singl": 0, "cpuset": 0, "tag": [0, 9], "4": [0, 1, 3, 9, 13], "gb": 0, "memori": [0, 4], "rss": 0, "done": [0, 1, 16], "fly": 0, "memoryus": [0, 9], "4g": 0, "deni": [0, 9], "rlimit": 0, "cap": 0, "activ": [0, 6, 9, 12, 14], "In": [0, 1, 3, 11, 13, 14], "testjail": [0, 2], "execut": [0, 7, 9, 11], "pcpu": [0, 9], "doubl": 0, "confirm": 0, "p": [0, 14], "pkglist": [0, 9], "need": [0, 1, 4, 7, 9, 10, 13, 14, 16], "json": [0, 9, 14], "file": [0, 1, 3, 7, 9, 11, 14], "contain": [0, 4, 6, 7, 9, 13, 14], "per": [0, 4, 9, 13], "line": [0, 1, 3, 7, 9, 11, 14], "internet": 0, "connect": [0, 13, 16], "pkg": [0, 3, 6, 9, 12, 14], "obtain": 0, "onlin": 0, "repositori": [0, 7], "add": [0, 3, 9, 11, 13, 14, 16], "nginx": [0, 16], "tmux": 0, "path": [0, 3, 6, 7, 9, 12, 14], "newli": [0, 1], "section": [1, 2, 3, 4, 10, 11, 13], "about": [1, 2, 9, 11, 13], "how": [1, 4, 14], "refer": [1, 4, 14], "rememb": [1, 3, 7, 16], "help": [1, 2], "alwai": [1, 2], "type": [1, 6, 7, 9, 11, 12, 14], "subcommand": [1, 8], "ha": [1, 2, 6, 9, 10, 11, 13, 16], "flow": 1, "us": [1, 2, 3, 4, 6, 9, 10, 11, 14], "As": [1, 11], "interact": [1, 9, 11], "guid": 1, "them": [1, 9], "through": 1, "experiment": [1, 10, 13], "color": 1, "mode": [1, 3, 9, 14], "iocage_color": 1, "true": [1, 3, 9], "four": 1, "accept": [1, 9], "descript": 1, "iocage_logfil": 1, "locat": [1, 7, 9], "log": [1, 8, 9], "fals": [1, 8, 9, 14], "turn": 1, "cli": [1, 8, 9, 11], "output": [1, 9], "iocage_forc": 1, "automat": [1, 6], "migrat": [1, 6, 9, 12], "iocage_plugin_ip": 1, "ip_addr": [1, 9], "plugin": [1, 6, 9], "quickli": [1, 10], "queri": 1, "anoth": [1, 7, 13, 16], "program": [1, 4, 14], "script": [1, 9], "process": [1, 3, 9, 11, 14, 16], "depend": [1, 8], "shell": [1, 9], "being": 1, "csh": 1, "tcsh": 1, "bash": 1, "sh": 1, "differ": [1, 10, 16], "slightli": 1, "setenv": 1, "export": [1, 6, 7, 9, 12], "link": [1, 7, 13], "usabl": 1, "zpool": [1, 9], "most": 1, "case": [1, 9, 11], "primari": 1, "more": [1, 2, 4, 6, 7, 11, 13], "advanc": [1, 6], "design": [1, 4], "onc": [0, 1, 2, 10, 16], "readi": 1, "abl": 1, "immedi": [1, 10], "begin": [1, 2], "download": [1, 9], "open": [1, 2, 9, 13, 14], "menu": 1, "choos": [1, 9], "seen": 1, "9": [1, 13], "3": [1, 9, 13, 14], "eol": [1, 9], "10": [1, 7, 11, 13], "2": [1, 4, 7, 9, 10, 13], "number": [1, 13], "desir": [1, 13], "press": 1, "enter": [1, 9], "select": 1, "exit": [1, 5, 8, 9], "quit": 1, "recent": [1, 11, 13], "appli": 1, "fine": [1, 2, 7], "tune": 1, "If": [1, 4, 7, 9, 11, 13, 14], "specif": [1, 10, 11, 13, 14, 16], "mirror": 1, "ftp": 1, "hostnam": [1, 9], "org": [1, 9, 14], "pull": 1, "directori": [1, 7, 8, 9], "d": 1, "dir": [1, 9], "With": 1, "There": [1, 2, 7, 11, 13], "two": 1, "normal": [1, 6, 14], "detail": [1, 4, 13], "found": [1, 7, 9, 10, 14], "document": [1, 4, 13], "adjust": [1, 14], "either": 1, "invok": 1, "b": [1, 10], "clone": [1, 4, 6, 7, 9, 12, 13], "multipl": [1, 4, 9, 10, 13], "c": [1, 5], "show": [1, 3, 9, 13, 14], "numer": 1, "simpl": [1, 7, 14], "myjail": [1, 13], "boot": [1, 6, 9, 11], "custom": [1, 2, 3, 4, 10, 16], "inform": [1, 7, 11, 13], "page": [1, 4, 6, 13], "access": [1, 9], "man": 1, "see": [1, 2, 9, 14], "view": [1, 14], "templat": [1, 2, 4, 6, 9], "down": [1, 7], "state": [1, 9], "statu": [1, 9, 13], "read": [1, 9, 11], "column": 1, "each": [1, 10, 14], "partial": 1, "entri": [1, 5, 7, 9], "long": [1, 9, 11], "charact": [1, 11], "enough": [1, 11], "identifi": [1, 2], "altern": [1, 11], "oper": [1, 4, 6, 7, 10], "complex": 1, "do": [1, 3, 4, 8], "like": [1, 3, 9, 11], "26e8e027": 1, "f00c": 1, "11e4": 1, "8f7f": 1, "3c970e80eb61": 1, "iocaget": 1, "www": 1, "26e8": 1, "syntax": [1, 6, 7], "alreadi": [1, 9, 14], "best": [1, 6, 7, 9], "Be": [1, 13], "note": [1, 2, 14, 16], "full": [1, 9, 14], "displai": [1, 4, 9], "irreversibli": 1, "allow": [1, 2, 4, 9, 11], "alter": 1, "jail1": 1, "testingjail": 1, "some": [2, 4, 6, 7, 11], "gener": [2, 4, 9, 13, 14], "guidelin": 2, "tip": 2, "work": [2, 4, 7, 11, 13], "manag": [2, 4, 7], "jail": [2, 4, 9, 11, 14, 16], "pf": [2, 4, 11], "modul": [2, 6, 12], "kernel": [2, 11, 13], "seem": 2, "vnet": [2, 3, 4, 6, 9], "bug": 2, "onli": [2, 4, 6, 9, 10, 11, 13], "trigger": 2, "directli": [2, 3, 13], "compil": [2, 11], "creat": [2, 4, 6, 9, 10, 12, 13, 14, 16], "avoid": 2, "mistak": 2, "easili": [2, 7, 14, 16], "properti": [2, 9, 10, 13, 14, 16], "someth": 2, "meaning": 2, "especi": 2, "infrequ": 2, "root": [2, 3, 7, 9, 14], "tester": 2, "been": 2, "updat": [2, 6, 9, 12, 14], "get": [2, 3, 9, 12, 13, 14], "control": [2, 13], "isol": [2, 13], "own": 2, "firewal": [2, 4], "known": [2, 6, 9, 13], "issu": [2, 6, 13], "discov": 2, "simplifi": [2, 4], "give": 2, "try": [2, 9], "restart": [2, 6, 9, 11, 12], "instead": 2, "perform": 2, "soft": [2, 9, 11], "leav": [2, 9, 16], "stack": [2, 4, 6, 9, 13], "alon": 2, "less": [2, 14], "stress": 2, "both": [2, 4, 11, 13], "check": [2, 4, 9, 13, 14], "rule": [2, 3, 9, 14], "ipfw": [2, 4, 11], "insid": [2, 4, 6, 9, 13], "put": 2, "firewall_en": 2, "firewall_typ": 2, "exclud": 2, "accident": 2, "block": 2, "right": [2, 9], "re": [2, 9], "lock": 2, "mix": [2, 9], "delet": [0, 2, 7, 9], "old": [2, 9], "snapshot": [2, 6, 9, 11, 12], "unnecessari": 2, "where": [2, 4, 10, 13, 14], "constantli": 2, "debjail": 3, "replac": [3, 7, 9, 13], "your": [3, 4, 7], "product": [3, 11], "intent": 3, "anyth": [3, 9], "empti": [3, 6, 7, 9], "e": [3, 7, 10, 13], "exec_start": 3, "bin": [3, 7], "exec_stop": 3, "instal": [3, 6, 9, 14, 16], "debootstrap": 3, "sysrc": [3, 13], "linux_en": 3, "linux_mounts_en": 3, "NO": 3, "servic": [3, 7, 11], "grab": 3, "mountpoint": [3, 7, 9, 11], "append": [3, 7], "apart": 3, "you": [0, 3, 4, 16], "ubuntu": 3, "eg": 3, "bionic": 3, "fstab": [3, 9, 10, 12], "edit": [3, 7], "devf": [3, 9, 14], "dev": 3, "rw": [3, 7], "tmpf": 3, "shm": 3, "size": [3, 9], "1g": 3, "1777": 3, "fdescf": 3, "fd": 3, "linrdlnk": 3, "linproc": 3, "proc": 3, "linprocf": 3, "linsi": 3, "sy": [3, 5], "linsysf": 3, "attach": [3, 4, 9], "consol": [3, 9, 12, 13], "result": 3, "64": [3, 13], "bit": 3, "userland": 3, "what": [4, 9, 14], "administr": 4, "task": 4, "o": 4, "virtual": [4, 6, 13], "technologi": [4, 6, 7], "term": 4, "zone": 4, "independ": [4, 10, 16], "network": [4, 6, 7, 9, 10, 16], "configur": [4, 6, 9, 14, 16], "interfac": [4, 6, 9, 11], "share": [4, 6], "ipjail": 4, "ip4_add": 4, "ip": [4, 6, 9, 14], "netmask": 4, "info": [4, 7], "pleas": [4, 14], "my": 4, "gatewai": [4, 9, 13], "address": [4, 9, 11, 13], "bridg": [4, 9, 13], "howev": [4, 7], "still": 4, "plan": 4, "securelevel": 4, "traffic": [4, 13], "thin": [4, 6], "provis": [4, 6], "too": [4, 11], "These": [4, 10, 13], "limit": [4, 6], "cpu": 4, "legaci": [4, 6], "resourc": [4, 6, 9, 13], "consumpt": 4, "df": [4, 9, 12], "nat": [4, 9, 14], "built": [4, 13], "treat": 4, "server": [4, 9], "core": [4, 14], "router": [4, 9], "chapter": 4, "Will": [4, 9], "pool": [4, 9], "No": [4, 16], "should": [4, 8, 14], "written": 6, "python": 6, "combin": 6, "featur": [6, 7], "offer": [6, 14], "gear": [6, 7], "eas": [6, 7], "simplist": 6, "easi": 6, "learn": 6, "rapid": 6, "within": [6, 7, 16], "second": [6, 16], "packag": [6, 12, 16], "non": 6, "dedic": 6, "dataset": [6, 9], "binari": 6, "import": [5, 6, 9, 12], "And": [6, 10], "mani": 6, "github": [5, 6, 14], "build": 6, "port": 6, "upgrad": [6, 9, 10, 12, 14], "iocage_legaci": 6, "ezjail": [6, 10], "basic": 6, "usag": [6, 9], "environ": [6, 10], "variabl": 6, "fetch": [6, 9, 12, 14], "list": [6, 7, 9, 10, 11, 12, 14, 16], "renam": [6, 9, 12], "vimag": 6, "thickjail": [6, 9], "practic": 6, "auto": [6, 13], "debian": 6, "buster": 6, "nativ": 6, "linux": [6, 10], "mount": [6, 7, 9, 10], "ipv6": [6, 9, 13], "bind": 6, "failur": 6, "faq": 6, "index": [6, 9], "search": 6, "merg": 7, "visit": 7, "sudo": 7, "py38": 7, "tree": [7, 9], "src_base": 7, "usr": 7, "src": [7, 9], "python38": 7, "git": 7, "lite": 7, "cython": 7, "libzf": 7, "pip": 7, "http": [5, 7, 9, 14], "com": [5, 7, 9, 14], "subsequ": 7, "possibl": 7, "pre": 7, "sysutil": 7, "py": 7, "cd": [7, 11], "clean": [7, 9, 12], "back": [7, 9, 13, 16], "onestart": 7, "assumpt": 7, "act": 7, "newjail": 7, "symlink": [7, 9], "reli": 7, "utlil": 7, "look": [7, 9], "l": 7, "oldjail": 7, "lrwxr": 7, "xr": 7, "x": [7, 9], "wheel": 7, "13": 7, "feb": 7, "22": 7, "2017": 7, "would": [7, 13], "doesn": [7, 9], "becaus": [7, 9], "ln": 7, "rsync": 7, "main": [5, 7, 8, 12], "part": 7, "via": 7, "grep": 7, "userland_vers": 7, "p6": 7, "goe": 7, "local": [7, 14], "jail_oldjail_ip": 7, "em0": [7, 13, 14], "192": [7, 13, 14], "168": [7, 13, 14], "ip4_addr": [7, 13, 14], "24": [7, 13], "subnet": [7, 9, 13], "mask": 7, "shut": 7, "so": [7, 8, 9, 16], "won": 7, "conflict": 7, "admin": 7, "well": [7, 9, 11], "cat": 7, "nullf": [7, 10], "ro": 7, "remain": [7, 16], "validate_count": [8, 12], "ctx": 8, "param": 8, "string": [8, 9], "comma": [8, 9], "return": [8, 9], "int": 8, "child_test": [8, 12], "iocroot": [8, 9], "_type": 8, "forc": [0, 8, 9, 13], "recurs": [8, 9], "children": [8, 9], "ioc": 8, "class": [8, 9], "ioclogg": [8, 12], "object": [8, 9, 14], "setconsoleloglevel": [8, 12], "iocagecli": [8, 12], "str": 8, "none": [8, 9, 13], "invoke_without_command": 8, "bool": [8, 9], "no_args_is_help": 8, "subcommand_metavar": 8, "chain": 8, "result_callback": 8, "callabl": [8, 9], "attr": 8, "multicommand": 8, "iter": [8, 9], "load": [8, 9], "definit": [8, 9], "get_command": [8, 12], "context": [8, 9], "list_command": [8, 12], "infohandl": [8, 12], "handler": 8, "emit": [8, 12], "whatev": 8, "actual": [8, 9], "intend": [8, 10], "subclass": 8, "rais": 8, "notimplementederror": 8, "print_vers": [8, 12], "print": 8, "ioccheck": [9, 12], "silent": 9, "callback": [9, 12], "reset_cach": [9, 12], "present": [9, 11], "iocclean": [9, 12], "clean_al": [9, 12], "everyth": [9, 13], "relat": 9, "clean_debug": [9, 12], "debug": [9, 12], "clean_imag": [9, 12], "imag": 9, "clean_jail": [9, 12], "respect": 9, "clean_releas": [9, 12], "clean_templ": [9, 12], "common": 9, "we": 9, "reus": 9, "boolean_prop_exist": [9, 12], "supplied_prop": 9, "props_to_check": 9, "_log": 9, "callback_except": 9, "helper": 9, "call": [9, 13], "appropri": [9, 10], "check_release_new": [9, 12], "raise_error": 9, "major_onli": 9, "greater": 9, "than": 9, "target": [0, 9], "check_truthi": [9, 12], "checkoutput": [9, 12], "arg": 9, "kwarg": 9, "just": [9, 16], "wrapper": 9, "utf": 9, "check_output": 9, "construct_truthi": [9, 12], "item": 9, "invers": 9, "truthi": 9, "variat": 9, "consume_and_log": [9, 12], "exec_gen": 9, "consum": [9, 10], "massag": 9, "copytre": [9, 12], "dst": 9, "ignor": 9, "overwrit": 9, "gen_nat_ip": [9, 12], "ip_prefix": 9, "effort": 9, "alloc": 9, "privat": 9, "gen_unused_lo_ip": [9, 12], "localhost": 9, "generate_devfs_ruleset": [9, 12], "includ": [3, 9, 14], "ruleset": [9, 14], "equal": 9, "devfs_ruleset": [9, 14], "get_active_jail": [9, 12], "get_host_gatewai": [9, 12], "get_host_releas": [9, 12], "sanit": 9, "get_jail_freebsd_vers": [9, 12], "get_jails_with_config": [9, 12], "filter": [9, 13], "mapping_func": 9, "get_name_sortkei": [9, 12], "get_natural_sortkei": [9, 12], "text": 9, "get_nested_kei": [9, 12], "_dict": 9, "kei": [9, 14], "nest": 9, "dictionari": [9, 14], "get_size_sortkei": [9, 12], "get_used_ip": [9, 12], "ifconfig": [9, 13], "everi": 9, "iterat": 9, "inus": 9, "ioc_sort": [9, 12], "caller": 9, "s_type": 9, "logit": [9, 12], "_callback": 9, "except": 9, "runtimeerror": 9, "our": 9, "lowercase_set": [9, 12], "match_to_dir": [9, 12], "old_uuid": 9, "dot": 9, "underscor": 9, "pattern": 9, "_": 9, "match": 9, "wa": [9, 10], "background": 9, "foo_bar": 9, "consid": [9, 13], "ident": 9, "cannot": [9, 13, 16], "coexist": 9, "open_atom": [9, 12], "filepath": 9, "temporari": 9, "atom": 9, "move": 9, "destin": 9, "upon": 9, "write": [5, 9], "filenam": 9, "fsync": 9, "whether": [9, 16], "disk": 9, "valid": [9, 14], "argument": [5, 9], "keyword": 9, "parse_latest_releas": [9, 12], "upstream": 9, "parse_package_nam": [9, 12], "raise_sort_error": [9, 12], "sort_list": 9, "retrieve_admin_port": [9, 12], "jail_run": 9, "admin_port": 9, "default_gatewai": 9, "full_ipv4_dict": 9, "retrieve_ip4_for_jail": [9, 12], "runscript": [9, 12], "custom_env": 9, "tupl": [5, 9], "stdout": 9, "last": 9, "stderr": 9, "set_interact": [9, 12], "tty": 9, "set_rcconf": [9, 12], "jail_path": 9, "sort_ava": [9, 12], "ava": 9, "sort": 9, "sort_boot": [9, 12], "sort_creat": [9, 12], "crt": 9, "sort_crt": [9, 12], "sort_ip": [9, 12], "sort_row": 9, "follow": [9, 13, 14], "dhcp": [9, 13, 14], "5": [9, 13], "accept_rtadv": 9, "obvious": 9, "forget": 9, "sort_ip6": [9, 12], "sort_jid": [9, 12], "jid": 9, "sort_kei": [9, 12], "sort_nam": [9, 12], "sort_qta": [9, 12], "qta": 9, "sort_releas": [9, 12], "split": 9, "fetch_releas": [9, 12], "sort_r": [9, 12], "rsize": 9, "sort_stat": [9, 12], "sort_templ": [9, 12], "sort_typ": [9, 12], "jail_typ": 9, "sort_us": [9, 12], "tempfil": [9, 12], "suffix": 9, "find": [9, 13, 16], "free": 9, "even": 9, "save": [9, 16], "tmp_dataset_check": [9, 12], "truthy_inverse_valu": [9, 12], "truthy_valu": [9, 12], "try_convert": [9, 12], "validate_plugin_manifest": [9, 12], "manifest": [9, 14], "ioccreat": [9, 12], "prop": 9, "num": 9, "config": 9, "short": [9, 11], "thickconfig": 9, "clone_basejail": 9, "create_config": [9, 12], "jail_uuid": 9, "source_templ": 9, "minim": 9, "self": 9, "create_install_packag": [9, 12], "repo": 9, "resolv": 9, "create_jail": [9, 12], "catch": 9, "sigint": 9, "create_rc": [9, 12], "host_hostnam": 9, "boilerpl": 9, "otherwis": [9, 11], "create_thickjail": [9, 12], "collect": 9, "iocdebug": [9, 12], "h": 9, "nsswitch": 9, "netstat": 9, "nr": 9, "run_debug": [9, 12], "run_host_debug": [9, 12], "run_jail_debug": [9, 12], "iocdestroi": [9, 12], "destroy_jail": [9, 12], "conveni": 9, "__stop_jails__": 9, "__destroy_parse_datasets__": 9, "commandfail": [9, 12], "messag": 9, "exceptionwithmsg": [9, 12], "commandneedsroot": [9, 12], "attribut": 9, "jailcorruptconfigur": [9, 12], "jailmisconfigur": [9, 12], "jailmissingconfigur": [9, 12], "jailrun": [9, 12], "poolnotactiv": [9, 12], "validationfail": [9, 12], "valuenotfound": [9, 12], "ignore_except": [9, 12], "suppress_except": 9, "exec": [9, 12, 13], "iocexec": [9, 12], "host_us": 9, "jail_us": 9, "unjail": 9, "skip": 9, "stdin_bytestr": 9, "su_env": 9, "decod": 9, "jexec": 9, "exec_jail": [9, 12], "flight_check": [9, 12], "interactiveexec": [9, 12], "silentexec": [9, 12], "iocfetch": [9, 12], "anonym": 9, "password": 9, "auth": 9, "root_dir": 9, "_file": 9, "verifi": [9, 13], "harden": 9, "txz": 9, "lib32": 9, "fetch_download": [9, 12], "_list": 9, "miss": 9, "fetch_extract": [9, 12], "f": [0, 9], "dest": 9, "fetch_http_releas": [9, 12], "xx": 9, "small": [9, 10], "fetch_upd": [9, 12], "update_progress": [9, 12], "progress": 9, "display_text": 9, "elaps": 9, "chunk_siz": 9, "origin": [9, 10], "stackoverflow": 9, "15860757": 9, "1391441": 9, "manipul": 9, "structur": [9, 14], "fs_file": [9, 12], "union": 9, "member": [9, 13], "fs_freq": [9, 12], "fs_mntop": [9, 12], "fs_passno": [9, 12], "fs_spec": [9, 12], "fs_type": [9, 12], "fs_vfstype": [9, 12], "iocfstab": [9, 12], "action": 9, "fstype": 9, "fsoption": 9, "fsdump": 9, "fspass": 9, "header": 9, "umount": 9, "fstab_list": [9, 12], "tabl": 9, "iocimag": [9, 12], "export_jail": [9, 12], "compression_algo": 9, "zip": 9, "import_jail": [9, 12], "convert": [9, 10, 16], "iocconfigur": [9, 12], "checking_dataset": 9, "backup_iocage_jail_conf": [9, 12], "check_config": [9, 12], "input": 9, "check_default_config": [9, 12], "check_jail_config": [9, 12], "fix_properti": [9, 12], "bad": 9, "previous": [9, 13], "fix": 9, "correct": 9, "equival": 9, "aren": 9, "config_vers": 9, "bump": 9, "static": 9, "get_mac_prefix": [9, 12], "get_pool_and_iocroot": [9, 12], "intern": 9, "get_vers": [9, 12], "json_writ": [9, 12], "retrieve_default_prop": [9, 12], "validate_mac_prefix": [9, 12], "mac_prefix": 9, "ioccpuset": [9, 12], "retrieve_cpu_set": [9, 12], "set_cpuset": [9, 12], "validate_cpuset_prop": [9, 12], "iocjson": [9, 12], "suppress_log": 9, "ucl": 9, "format": [5, 9], "default_only_prop": [9, 12], "nat_prefix": 9, "nat_interfac": 9, "nat_backend": 9, "get_full_config": [9, 12], "json_check_prop": [9, 12], "good": 9, "json_convert_from_ucl": [9, 12], "json_convert_from_zf": [9, 12], "json_get_valu": [9, 12], "json_load": [9, 12], "json_migrate_uuid_to_tag": [9, 12], "json_plugin_get_valu": [9, 12], "json_plugin_load": [9, 12], "json_plugin_set_valu": [9, 12], "json_set_valu": [9, 12], "_import": 9, "truthy_prop": [9, 12], "bpf": [3, 9, 14], "host_tim": 9, "rtsold": 9, "jail_zf": 9, "hostid_strict_check": 9, "exec_clean": 9, "mount_linprocf": 9, "mount_procf": 9, "allow_vmm": 9, "allow_tun": 9, "allow_socket_af": [3, 9], "allow_quota": 9, "allow_mount_zf": 9, "allow_mount_tmpf": 9, "allow_mount_procf": 9, "allow_mount_nullf": 9, "allow_mount_fusef": 9, "allow_mount_devf": [3, 9], "allow_mount_fdescf": 9, "allow_mount": [3, 9], "allow_mlock": 9, "allow_chflag": 9, "allow_raw_socket": [3, 9], "allow_sysvipc": 9, "allow_set_hostnam": 9, "mount_fdescf": 9, "mount_devf": 9, "ip6_saddrsel": 9, "ip4_saddrsel": 9, "ip_hostnam": 9, "assign_localhost": 9, "iocrctl": [9, 12], "rctl_rules_exist": [9, 12], "remove_rctl_rul": [9, 12], "set_rctl_rul": [9, 12], "coredumps": 9, "cputim": 9, "datas": 9, "maxproc": 9, "memorylock": 9, "msgqqueu": 9, "msgqsize": 9, "nmsgq": 9, "nsem": 9, "nsemop": 9, "nshm": 9, "nthr": 9, "openfil": 9, "pseudotermin": 9, "readbp": 9, "readiop": 9, "shmsize": 9, "stacksiz": 9, "swapus": 9, "vmemoryus": 9, "wallclock": 9, "writebp": 9, "writeiop": 9, "validate_rctl_prop": [9, 12], "validate_rctl_tun": [9, 12], "jailruntimeconfigur": [9, 12], "jail_nam": 9, "normalize_data": [9, 12], "sync_chang": [9, 12], "ioclist": [9, 12], "lst_type": 9, "hdr": 9, "_sort": 9, "quick": 9, "uid": 9, "ip4": 9, "list_al": [9, 12], "list_all_quick": [9, 12], "list_bas": [9, 12], "list_dataset": [9, 12], "classmethod": 9, "list_get_jid": [9, 12], "id": 9, "iocplugin": [9, 12], "branch": 9, "keep_jail_on_failur": 9, "respons": 9, "life": 9, "cycl": 9, "default_prop": [9, 12], "plugin_vers": [9, 12], "expand_abi_with_specified_releas": [9, 12], "packagesit": [9, 14], "fetch_plugin": [9, 12], "accept_licens": 9, "fetch_plugin_index": [9, 12], "list_head": 9, "list_long": 9, "icon": [9, 14], "offici": [9, 14], "index_onli": 9, "fetch_plugin_packagesit": [9, 12], "package_sit": 9, "fetch_plugin_vers": [9, 12], "fetch_plugin_versions_from_plugin_index": [9, 12], "plugins_index": 9, "pull_clone_git_repo": [9, 12], "depth": [9, 13], "retrieve_plugin_index_data": [9, 12], "plugin_index_path": 9, "expand_abi": 9, "retrieve_plugin_json": [9, 12], "start_rc": [9, 12], "stop_rc": [9, 12], "iocstart": [9, 12], "is_depend": 9, "unit_test": 9, "used_port": 9, "exec_": 9, "check_alias": [9, 12], "alia": [9, 13], "find_bridge_mtu": [9, 12], "get_bridge_memb": [9, 12], "get_default_gatewai": [9, 12], "address_famili": 9, "ipv4": [9, 13], "get_default_interfac": [9, 12], "start_copy_localtim": [9, 12], "start_generate_resolv": [9, 12], "start_network": [9, 12], "larg": [9, 10], "pass": [9, 13], "boolean": 9, "start_network_interface_vnet": [9, 12], "nic_def": 9, "net_config": 9, "nat_addr": 9, "separ": [9, 13], "nic": 9, "pair": 9, "start_network_vnet_addr": [9, 12], "ifac": 9, "defaultgw": 9, "error": 9, "occur": [9, 13], "start_network_vnet_ifac": [9, 12], "mtu": 9, "real": 9, "meat": 9, "potato": 9, "iocstop": [9, 12], "unmount": 9, "iocupgrad": [9, 12], "new_releas": 9, "upgrade_basejail": [9, 12], "snap_nam": 9, "upgrade_jail": [9, 12], "skip_jail": 9, "chroot": [9, 12], "deprec": 9, "d_type": 9, "count": 9, "_uuid": 9, "skip_batch": 9, "deactiv": [9, 12], "reduc": 9, "perfom": 9, "hit": 9, "destroy_releas": [9, 12], "ask": 9, "start_jail": 9, "msg_return": 9, "exec_al": [9, 12], "dump": 9, "_pass": 9, "add_path": 9, "import_": [9, 12], "new_nam": 9, "rollback": [9, 11, 12], "roll": 9, "snap_list": [9, 12], "gather": 9, "snap_remov": [9, 12], "patchset": 9, "update_al": [9, 12], "upgrade_al": [9, 12], "poolanddataset": [9, 12], "get_iocroot": [9, 12], "get_pool": [9, 12], "sever": 10, "benefit": 10, "drawback": 10, "serv": [10, 13], "varieti": 10, "uniqu": [10, 11], "describ": 10, "duplic": [10, 11], "amount": 10, "concept": 10, "popular": [10, 14], "littl": 10, "startup": 10, "ideal": 10, "further": 10, "satisfi": 10, "newexamplejail": 10, "unsupport": 10, "setup": [10, 12], "transmiss": [10, 13], "between": [10, 11, 13, 16], "send": 10, "receiv": 10, "length": 11, "histor": 11, "88": 11, "doe": [11, 13], "challeng": 11, "dive": 11, "tar": 11, "around": 11, "shorten": 11, "caus": [11, 13], "unexpect": [11, 13], "crash": [11, 13], "word": 11, "kill": 11, "workaround": 11, "stabl": 11, "machin": 11, "over": [11, 13], "100": [11, 14], "dai": 11, "uptim": 11, "p10": 11, "interest": 11, "queue": 11, "rout": [11, 13], "softwar": 11, "kernconf": 11, "unless": 11, "disabl": [11, 13], "altq_cbq": 11, "altq_r": 11, "altq_rio": 11, "altq_hfsc": 11, "altq_cdnr": 11, "altq_priq": 11, "2014": 11, "mail": 11, "post": 11, "ip6": 11, "defin": 11, "fail": 11, "happen": 11, "sysctl": [11, 13], "dad": 11, "detect": 11, "probe": 11, "packet": [11, 13], "net": [11, 13], "inet6": 11, "dad_count": 11, "perman": 11, "2013": 11, "fastentrypoint": 12, "iocage_cli": 12, "submodul": 12, "content": [12, 16], "iocage_lib": 12, "ioc_check": 12, "ioc_clean": 12, "ioc_common": 12, "ioc_creat": 12, "ioc_debug": 12, "ioc_destroi": 12, "ioc_except": 12, "ioc_exec": 12, "ioc_fetch": 12, "ioc_fstab": 12, "ioc_imag": 12, "ioc_json": 12, "ioc_list": 12, "ioc_plugin": 12, "ioc_start": 12, "ioc_stop": 12, "ioc_upgrad": 12, "conftest": 12, "data_class": 12, "better": [5, 13], "tradition": 13, "commun": 13, "typic": 13, "develop": [13, 14], "sometim": 13, "abstract": 13, "behav": 13, "physic": 13, "instruct": 13, "rest": 13, "along": 13, "adapt": 13, "placehold": 13, "comput": 13, "hardwar": 13, "compon": 13, "rock": 13, "solid": 13, "decad": 13, "heavi": 13, "few": 13, "step": 13, "examplejail1": 13, "off": 13, "direct": 13, "visibl": 13, "sctp": 13, "rebuild": 13, "nooption": 13, "stream": 13, "protocol": 13, "racct": 13, "rctl": 13, "On": 13, "node": 13, "cloned_interfac": 13, "bridge0": 13, "plumb": 13, "ifconfig_bridge0": 13, "addm": 13, "ifconfig_em0": 13, "tunabl": 13, "inet": 13, "forward": 13, "pfil_onlyip": 13, "pfil": 13, "pfil_bridg": 13, "pfil_memb": 13, "defaultrout": 13, "254": 13, "vnet0": 13, "ping": 13, "know": [13, 16], "vlan": 13, "parent": 13, "vlans_em0": 13, "666": 13, "ifconfig_em0_666": 13, "vnet_default_interfac": 13, "vnet1": 13, "bridge1": 13, "hand": 13, "ip6_addr": 13, "2001": 13, "123": 13, "456": 13, "242": 13, "defaultrouter6": 13, "impli": 13, "berklei": 13, "6": [3, 13], "regener": 13, "mac": 13, "hw": 13, "g": 13, "next": 13, "vnet0_mac": 13, "veri": 14, "fast": [5, 14], "applic": 14, "At": 14, "repeatedli": 14, "addition": 14, "extend": 14, "high": 14, "customiz": 14, "consist": 14, "png": 14, "pr": 14, "remot": 14, "modifi": [14, 16], "IF": 14, "manner": 14, "plexmediaserv": 14, "igb0": 14, "91": 14, "re0": 14, "individu": 14, "quasselcor": 14, "complet": 14, "freena": 14, "50": 14, "hello": 14, "world": 14, "exactli": 14, "default_jail_name_her": 14, "artifact": 14, "git_path_to_plugin_repo": 14, "nat_forward": 14, "tcp": 14, "7878": 14, "null": 14, "abi": 14, "fingerprint": 14, "sha256": 14, "b0170035af3acc5f3f3ae1859dc717101b4e6c1d0a794ad554928ca0cbb2f438": 14, "revis": 14, "translat": 14, "unhid": [3, 14], "dynam": 14, "ruleset_numb": 14, "include_valu": 14, "preciou": 16, "preconfigur": 16, "deploy": 16, "mytempl": 16, "php": 16, "jailfromtempl": 16, "sinc": 16, "wish": 16, "unaffect": 16, "thick": 16, "newtempl": 16, "get_arg": [5, 12], "monkei": 5, "setuptool": 5, "faster": 5, "console_script": 5, "mymodul": 5, "entry_funct": 5, "2016": 5, "aaron": 5, "christianson": 5, "ninjaaron": 5, "entry_point": 5, "implicit": [], "instanc": [], "declar": [], "idiom": [], "def": [], "cl": [], "arg1": [], "arg2": [], "deriv": [], "java": [], "want": 0, "staticmethod": [], "builtin": [], "allow_mount_linprocf": [3, 9], "allow_nfsd": 9, "devfsrules_jail_linux": 3, "devfsrules_hide_al": 3, "devfsrules_unhide_bas": 3, "devfsrules_unhide_login": 3, "tun": 3, "bookworm": 3, "allow_mount_linsysf": [3, 9], "yield": 5, "write_script": 5, "distribut": 5, "gui_script": 5}, "objects": {"": [[5, 0, 0, "-", "fastentrypoints"], [8, 0, 0, "-", "iocage_cli"], [9, 0, 0, "-", "iocage_lib"]], "fastentrypoints": [[5, 1, 1, "", "get_args"], [5, 1, 1, "", "main"]], "iocage_cli": [[8, 2, 1, "", "IOCLogger"], [8, 2, 1, "", "IOCageCLI"], [8, 2, 1, "", "InfoHandler"], [8, 0, 0, "-", "activate"], [8, 0, 0, "-", "chroot"], [8, 0, 0, "-", "clean"], [8, 0, 0, "-", "clone"], [8, 0, 0, "-", "console"], [8, 0, 0, "-", "create"], [8, 0, 0, "-", "debug"], [8, 0, 0, "-", "destroy"], [8, 0, 0, "-", "df"], [8, 0, 0, "-", "exec"], [8, 0, 0, "-", "export"], [8, 0, 0, "-", "fetch"], [8, 0, 0, "-", "fstab"], [8, 0, 0, "-", "get"], [8, 0, 0, "-", "import"], [8, 0, 0, "-", "list"], [8, 0, 0, "-", "migrate"], [8, 0, 0, "-", "pkg"], [8, 1, 1, "", "print_version"], [8, 0, 0, "-", "rename"], [8, 0, 0, "-", "restart"], [8, 0, 0, "-", "rollback"], [8, 0, 0, "-", "set"], [8, 0, 0, "-", "snaplist"], [8, 0, 0, "-", "snapremove"], [8, 0, 0, "-", "snapshot"], [8, 0, 0, "-", "start"], [8, 0, 0, "-", "stop"], [8, 0, 0, "-", "update"], [8, 0, 0, "-", "upgrade"]], "iocage_cli.IOCLogger": [[8, 3, 1, "", "setConsoleLogLevel"]], "iocage_cli.IOCageCLI": [[8, 3, 1, "", "get_command"], [8, 3, 1, "", "list_commands"]], "iocage_cli.InfoHandler": [[8, 3, 1, "", "emit"]], "iocage_cli.clone": [[8, 1, 1, "", "validate_count"]], "iocage_cli.create": [[8, 1, 1, "", "validate_count"]], "iocage_cli.destroy": [[8, 1, 1, "", "child_test"]], "iocage_cli.fetch": [[8, 1, 1, "", "validate_count"]], "iocage_lib": [[9, 0, 0, "-", "ioc_check"], [9, 0, 0, "-", "ioc_clean"], [9, 0, 0, "-", "ioc_common"], [9, 0, 0, "-", "ioc_create"], [9, 0, 0, "-", "ioc_debug"], [9, 0, 0, "-", "ioc_destroy"], [9, 0, 0, "-", "ioc_exceptions"], [9, 0, 0, "-", "ioc_exec"], [9, 0, 0, "-", "ioc_fetch"], [9, 0, 0, "-", "ioc_fstab"], [9, 0, 0, "-", "ioc_image"], [9, 0, 0, "-", "ioc_json"], [9, 0, 0, "-", "ioc_list"], [9, 0, 0, "-", "ioc_plugin"], [9, 0, 0, "-", "ioc_start"], [9, 0, 0, "-", "ioc_stop"], [9, 0, 0, "-", "ioc_upgrade"], [9, 0, 0, "-", "iocage"]], "iocage_lib.ioc_check": [[9, 2, 1, "", "IOCCheck"]], "iocage_lib.ioc_clean": [[9, 2, 1, "", "IOCClean"]], "iocage_lib.ioc_clean.IOCClean": [[9, 3, 1, "", "clean_all"], [9, 3, 1, "", "clean_debug"], [9, 3, 1, "", "clean_images"], [9, 3, 1, "", "clean_jails"], [9, 3, 1, "", "clean_releases"], [9, 3, 1, "", "clean_templates"]], "iocage_lib.ioc_common": [[9, 1, 1, "", "boolean_prop_exists"], [9, 1, 1, "", "callback"], [9, 1, 1, "", "check_release_newer"], [9, 1, 1, "", "check_truthy"], [9, 1, 1, "", "checkoutput"], [9, 1, 1, "", "construct_truthy"], [9, 1, 1, "", "consume_and_log"], [9, 1, 1, "", "copytree"], [9, 1, 1, "", "gen_nat_ip"], [9, 1, 1, "", "gen_unused_lo_ip"], [9, 1, 1, "", "generate_devfs_ruleset"], [9, 1, 1, "", "get_active_jails"], [9, 1, 1, "", "get_host_gateways"], [9, 1, 1, "", "get_host_release"], [9, 1, 1, "", "get_jail_freebsd_version"], [9, 1, 1, "", "get_jails_with_config"], [9, 1, 1, "", "get_name_sortkey"], [9, 1, 1, "", "get_natural_sortkey"], [9, 1, 1, "", "get_nested_key"], [9, 1, 1, "", "get_size_sortkey"], [9, 1, 1, "", "get_used_ips"], [9, 1, 1, "", "ioc_sort"], [9, 1, 1, "", "logit"], [9, 1, 1, "", "lowercase_set"], [9, 1, 1, "", "match_to_dir"], [9, 1, 1, "", "open_atomic"], [9, 1, 1, "", "parse_latest_release"], [9, 1, 1, "", "parse_package_name"], [9, 1, 1, "", "raise_sort_error"], [9, 1, 1, "", "retrieve_admin_portals"], [9, 1, 1, "", "retrieve_ip4_for_jail"], [9, 1, 1, "", "runscript"], [9, 1, 1, "", "set_interactive"], [9, 1, 1, "", "set_rcconf"], [9, 1, 1, "", "sort_ava"], [9, 1, 1, "", "sort_boot"], [9, 1, 1, "", "sort_created"], [9, 1, 1, "", "sort_crt"], [9, 1, 1, "", "sort_ip"], [9, 1, 1, "", "sort_ip6"], [9, 1, 1, "", "sort_jid"], [9, 1, 1, "", "sort_key"], [9, 1, 1, "", "sort_name"], [9, 1, 1, "", "sort_qta"], [9, 1, 1, "", "sort_release"], [9, 1, 1, "", "sort_res"], [9, 1, 1, "", "sort_state"], [9, 1, 1, "", "sort_template"], [9, 1, 1, "", "sort_type"], [9, 1, 1, "", "sort_use"], [9, 1, 1, "", "tempfile"], [9, 1, 1, "", "tmp_dataset_checks"], [9, 1, 1, "", "truthy_inverse_values"], [9, 1, 1, "", "truthy_values"], [9, 1, 1, "", "try_convert"], [9, 1, 1, "", "validate_plugin_manifest"]], "iocage_lib.ioc_create": [[9, 2, 1, "", "IOCCreate"]], "iocage_lib.ioc_create.IOCCreate": [[9, 3, 1, "", "create_config"], [9, 3, 1, "", "create_install_packages"], [9, 3, 1, "", "create_jail"], [9, 3, 1, "", "create_rc"], [9, 3, 1, "", "create_thickjail"]], "iocage_lib.ioc_debug": [[9, 2, 1, "", "IOCDebug"]], "iocage_lib.ioc_debug.IOCDebug": [[9, 3, 1, "", "run_debug"], [9, 3, 1, "", "run_host_debug"], [9, 3, 1, "", "run_jail_debug"]], "iocage_lib.ioc_destroy": [[9, 2, 1, "", "IOCDestroy"]], "iocage_lib.ioc_destroy.IOCDestroy": [[9, 3, 1, "", "destroy_jail"]], "iocage_lib.ioc_exceptions": [[9, 4, 1, "", "CommandFailed"], [9, 4, 1, "", "CommandNeedsRoot"], [9, 4, 1, "", "ExceptionWithMsg"], [9, 4, 1, "", "Exists"], [9, 4, 1, "", "JailCorruptConfiguration"], [9, 4, 1, "", "JailMisconfigured"], [9, 4, 1, "", "JailMissingConfiguration"], [9, 4, 1, "", "JailRunning"], [9, 4, 1, "", "PoolNotActivated"], [9, 4, 1, "", "ValidationFailed"], [9, 4, 1, "", "ValueNotFound"], [9, 1, 1, "", "ignore_exceptions"]], "iocage_lib.ioc_exec": [[9, 2, 1, "", "IOCExec"], [9, 2, 1, "", "InteractiveExec"], [9, 2, 1, "", "SilentExec"]], "iocage_lib.ioc_exec.IOCExec": [[9, 3, 1, "", "exec_jail"], [9, 3, 1, "", "flight_checks"]], "iocage_lib.ioc_fetch": [[9, 2, 1, "", "IOCFetch"]], "iocage_lib.ioc_fetch.IOCFetch": [[9, 3, 1, "", "fetch_download"], [9, 3, 1, "", "fetch_extract"], [9, 3, 1, "", "fetch_http_release"], [9, 3, 1, "", "fetch_release"], [9, 3, 1, "", "fetch_update"], [9, 3, 1, "", "update_progress"]], "iocage_lib.ioc_fstab": [[9, 2, 1, "", "Fstab"], [9, 2, 1, "", "IOCFstab"]], "iocage_lib.ioc_fstab.Fstab": [[9, 5, 1, "", "fs_file"], [9, 5, 1, "", "fs_freq"], [9, 5, 1, "", "fs_mntops"], [9, 5, 1, "", "fs_passno"], [9, 5, 1, "", "fs_spec"], [9, 5, 1, "", "fs_type"], [9, 5, 1, "", "fs_vfstype"]], "iocage_lib.ioc_fstab.IOCFstab": [[9, 3, 1, "", "fstab_list"]], "iocage_lib.ioc_image": [[9, 2, 1, "", "IOCImage"]], "iocage_lib.ioc_image.IOCImage": [[9, 3, 1, "", "export_jail"], [9, 3, 1, "", "import_jail"]], "iocage_lib.ioc_json": [[9, 2, 1, "", "IOCConfiguration"], [9, 2, 1, "", "IOCCpuset"], [9, 2, 1, "", "IOCJson"], [9, 2, 1, "", "IOCRCTL"], [9, 2, 1, "", "JailRuntimeConfiguration"]], "iocage_lib.ioc_json.IOCConfiguration": [[9, 3, 1, "", "backup_iocage_jail_conf"], [9, 3, 1, "", "check_config"], [9, 3, 1, "", "check_default_config"], [9, 3, 1, "", "check_jail_config"], [9, 3, 1, "", "fix_properties"], [9, 3, 1, "", "get_mac_prefix"], [9, 3, 1, "", "get_pool_and_iocroot"], [9, 3, 1, "", "get_version"], [9, 3, 1, "", "json_write"], [9, 3, 1, "", "retrieve_default_props"], [9, 3, 1, "", "validate_mac_prefix"]], "iocage_lib.ioc_json.IOCCpuset": [[9, 3, 1, "", "retrieve_cpu_sets"], [9, 3, 1, "", "set_cpuset"], [9, 3, 1, "", "validate_cpuset_prop"]], "iocage_lib.ioc_json.IOCJson": [[9, 5, 1, "", "default_only_props"], [9, 3, 1, "", "get_full_config"], [9, 3, 1, "", "json_check_prop"], [9, 3, 1, "", "json_convert_from_ucl"], [9, 3, 1, "", "json_convert_from_zfs"], [9, 3, 1, "", "json_get_value"], [9, 3, 1, "", "json_load"], [9, 3, 1, "", "json_migrate_uuid_to_tag"], [9, 3, 1, "", "json_plugin_get_value"], [9, 3, 1, "", "json_plugin_load"], [9, 3, 1, "", "json_plugin_set_value"], [9, 3, 1, "", "json_set_value"], [9, 5, 1, "", "truthy_props"]], "iocage_lib.ioc_json.IOCRCTL": [[9, 3, 1, "", "rctl_rules_exist"], [9, 3, 1, "", "remove_rctl_rules"], [9, 3, 1, "", "set_rctl_rules"], [9, 5, 1, "", "types"], [9, 3, 1, "", "validate_rctl_props"], [9, 3, 1, "", "validate_rctl_tunable"]], "iocage_lib.ioc_json.JailRuntimeConfiguration": [[9, 3, 1, "", "normalize_data"], [9, 6, 1, "", "path"], [9, 3, 1, "", "remove"], [9, 3, 1, "", "set"], [9, 3, 1, "", "sync_changes"]], "iocage_lib.ioc_list": [[9, 2, 1, "", "IOCList"]], "iocage_lib.ioc_list.IOCList": [[9, 3, 1, "", "list_all"], [9, 3, 1, "", "list_all_quick"], [9, 3, 1, "", "list_bases"], [9, 3, 1, "", "list_datasets"], [9, 3, 1, "", "list_get_jid"]], "iocage_lib.ioc_plugin": [[9, 2, 1, "", "IOCPlugin"]], "iocage_lib.ioc_plugin.IOCPlugin": [[9, 5, 1, "", "DEFAULT_PROPS"], [9, 5, 1, "", "PLUGIN_VERSION"], [9, 3, 1, "", "expand_abi_with_specified_release"], [9, 3, 1, "", "fetch_plugin"], [9, 3, 1, "", "fetch_plugin_index"], [9, 3, 1, "", "fetch_plugin_packagesites"], [9, 3, 1, "", "fetch_plugin_versions"], [9, 3, 1, "", "fetch_plugin_versions_from_plugin_index"], [9, 3, 1, "", "pull_clone_git_repo"], [9, 3, 1, "", "retrieve_plugin_index_data"], [9, 3, 1, "", "retrieve_plugin_json"], [9, 3, 1, "", "start_rc"], [9, 3, 1, "", "stop_rc"], [9, 3, 1, "", "update"], [9, 3, 1, "", "upgrade"]], "iocage_lib.ioc_start": [[9, 2, 1, "", "IOCStart"]], "iocage_lib.ioc_start.IOCStart": [[9, 3, 1, "", "check_aliases"], [9, 3, 1, "", "find_bridge_mtu"], [9, 3, 1, "", "get_bridge_members"], [9, 3, 1, "", "get_default_gateway"], [9, 3, 1, "", "get_default_interface"], [9, 3, 1, "", "start_copy_localtime"], [9, 3, 1, "", "start_generate_resolv"], [9, 3, 1, "", "start_network"], [9, 3, 1, "", "start_network_interface_vnet"], [9, 3, 1, "", "start_network_vnet_addr"], [9, 3, 1, "", "start_network_vnet_iface"]], "iocage_lib.ioc_stop": [[9, 2, 1, "", "IOCStop"]], "iocage_lib.ioc_upgrade": [[9, 2, 1, "", "IOCUpgrade"]], "iocage_lib.ioc_upgrade.IOCUpgrade": [[9, 3, 1, "", "upgrade_basejail"], [9, 3, 1, "", "upgrade_jail"]], "iocage_lib.iocage": [[9, 2, 1, "", "IOCage"], [9, 2, 1, "", "PoolAndDataset"]], "iocage_lib.iocage.IOCage": [[9, 3, 1, "", "activate"], [9, 3, 1, "", "chroot"], [9, 3, 1, "", "clean"], [9, 3, 1, "", "create"], [9, 3, 1, "", "deactivate"], [9, 3, 1, "", "debug"], [9, 3, 1, "", "destroy_jail"], [9, 3, 1, "", "destroy_release"], [9, 3, 1, "", "df"], [9, 3, 1, "", "exec"], [9, 3, 1, "", "exec_all"], [9, 3, 1, "", "export"], [9, 3, 1, "", "fetch"], [9, 3, 1, "", "fstab"], [9, 3, 1, "", "get"], [9, 3, 1, "", "import_"], [9, 3, 1, "", "list"], [9, 3, 1, "", "rename"], [9, 3, 1, "", "reset_cache"], [9, 3, 1, "", "restart"], [9, 3, 1, "", "rollback"], [9, 3, 1, "", "set"], [9, 3, 1, "", "snap_list"], [9, 3, 1, "", "snap_remove"], [9, 3, 1, "", "snapshot"], [9, 3, 1, "", "start"], [9, 3, 1, "", "stop"], [9, 3, 1, "", "update"], [9, 3, 1, "", "update_all"], [9, 3, 1, "", "upgrade"], [9, 3, 1, "", "upgrade_all"]], "iocage_lib.iocage.PoolAndDataset": [[9, 3, 1, "", "get_iocroot"], [9, 3, 1, "", "get_pool"]]}, "objtypes": {"0": "py:module", "1": "py:function", "2": "py:class", "3": "py:method", "4": "py:exception", "5": "py:attribute", "6": "py:property"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "function", "Python function"], "2": ["py", "class", "Python class"], "3": ["py", "method", "Python method"], "4": ["py", "exception", "Python exception"], "5": ["py", "attribute", "Python attribute"], "6": ["py", "property", "Python property"]}, "titleterms": {"advanc": 0, "usag": [0, 1], "clone": [0, 8, 10], "creat": [0, 1, 3, 7, 8], "promot": 0, "updat": [0, 7, 8], "jail": [0, 1, 3, 6, 7, 10, 13], "upgrad": [0, 7, 8], "auto": 0, "boot": 0, "prioriti": 0, "depend": 0, "properti": [0, 1], "snapshot": [0, 8], "manag": [0, 6], "resourc": 0, "limit": [0, 11], "legaci": 0, "onli": 0, "core": 0, "thread": 0, "list": [0, 1, 8], "appli": 0, "dram": 0, "us": [0, 7, 13, 16], "turn": 0, "check": 0, "cpu": 0, "automat": 0, "packag": [0, 7, 8, 9, 17], "instal": [0, 7], "basic": 1, "set": [1, 8], "environ": 1, "variabl": 1, "iocag": [1, 6, 7, 9, 12], "activ": [1, 8], "fetch": [1, 8], "releas": [1, 7], "start": [1, 7, 8], "stop": [1, 8], "restart": [1, 8], "configur": [1, 13], "get": [1, 8], "all": 1, "destroi": [1, 8], "renam": [1, 8], "best": 2, "practic": 2, "debian": 3, "buster": 3, "nativ": 3, "linux": 3, "faq": 4, "fastentrypoint": 5, "modul": [5, 8, 9, 15, 17], "A": 6, "freebsd": 6, "document": 6, "indic": 6, "tabl": 6, "binari": 7, "github": 7, "pkg": [7, 8], "8": 7, "build": 7, "port": 7, "from": 7, "iocage_legaci": 7, "migrat": [7, 8], "ezjail": 7, "target": 7, "copi": 7, "old": 7, "data": 7, "popul": 7, "config": 7, "json": 7, "ip": [7, 13], "address": 7, "new": 7, "option": 7, "fstab": [7, 8], "iocage_cli": 8, "submodul": [8, 9, 17], "chroot": 8, "clean": 8, "consol": 8, "debug": 8, "df": 8, "exec": 8, "export": 8, "import": 8, "rollback": 8, "snaplist": 8, "snapremov": 8, "content": [8, 9, 17], "iocage_lib": 9, "ioc_check": 9, "ioc_clean": 9, "ioc_common": 9, "paramet": 9, "ioc_creat": 9, "ioc_debug": 9, "ioc_destroi": 9, "ioc_except": 9, "ioc_exec": 9, "ioc_fetch": 9, "ioc_fstab": 9, "ioc_imag": 9, "ioc_json": 9, "ioc_list": 9, "ioc_plugin": 9, "ioc_start": 9, "ioc_stop": 9, "ioc_upgrad": 9, "type": 10, "default": 10, "basejail": 10, "templat": [10, 16], "empti": 10, "thickjail": 10, "known": 11, "issu": 11, "mount": 11, "path": 11, "vnet": [11, 13], "vimag": [11, 13], "w": 11, "altq": 11, "ipv6": 11, "host": 11, "bind": 11, "failur": 11, "network": 13, "share": 13, "tip": 13, "interfac": 13, "plugin": 14, "setup": 15, "test": 17, "conftest": 17, "data_class": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Advanced Usage": [[0, "advanced-usage"]], "Clones": [[0, "clones"]], "Create a Clone": [[0, "create-a-clone"]], "Promoting a Clone": [[0, "promoting-a-clone"]], "Updating Jails": [[0, "updating-jails"]], "Upgrading Jails": [[0, "upgrading-jails"]], "Auto-boot": [[0, "auto-boot"]], "Boot Priority": [[0, "boot-priority"]], "Depends Property": [[0, "depends-property"]], "Snapshot Management": [[0, "snapshot-management"]], "Resource Limits (Legacy ONLY)": [[0, "resource-limits-legacy-only"]], "Limit Cores or Threads": [[0, "limit-cores-or-threads"]], "List Applied Limits": [[0, "list-applied-limits"]], "Limit DRAM use": [[0, "limit-dram-use"]], "Turn on Resource Limits": [[0, "turn-on-resource-limits"]], "Apply limits": [[0, "apply-limits"]], "Check Limits": [[0, "check-limits"]], "Limit CPU Usage by %": [[0, "limit-cpu-usage-by"]], "Automatic Package Installation": [[0, "automatic-package-installation"]], "Basic Usage": [[1, "basic-usage"]], "Setting Environment Variables": [[1, "setting-environment-variables"]], "iocage Environment Variables": [[1, "id11"]], "Activate iocage": [[1, "activate-iocage"]], "Fetch a Release": [[1, "fetch-a-release"]], "Create a Jail": [[1, "create-a-jail"]], "Listing Jails": [[1, "listing-jails"]], "Start, Stop, or Restart a Jail": [[1, "start-stop-or-restart-a-jail"]], "Start": [[1, "start"]], "Stop": [[1, "stop"]], "Restart": [[1, "restart"]], "Configure a Jail": [[1, "configure-a-jail"]], "Set Jail Property": [[1, "set-jail-property"]], "Get Jail Property": [[1, "get-jail-property"]], "Get all properties:": [[1, "get-all-properties"]], "Destroy a Jail": [[1, "destroy-a-jail"]], "Rename a Jail": [[1, "rename-a-jail"]], "Best Practices": [[2, "best-practices"]], "Create a Debian Buster Jail (native Linux)": [[3, "create-a-debian-buster-jail-native-linux"]], "FAQ": [[4, "faq"]], "fastentrypoints module": [[5, "module-fastentrypoints"]], "iocage - A FreeBSD Jail Manager": [[6, "iocage-a-freebsd-jail-manager"]], "Documentation:": [[6, "documentation"]], "Indices and tables": [[6, "indices-and-tables"]], "Install iocage": [[7, "install-iocage"]], "Using binary packages": [[7, "using-binary-packages"]], "Using github": [[7, "using-github"]], "Using pkg(8)": [[7, "using-pkg-8"]], "Building Ports": [[7, "building-ports"]], "Upgrading from iocage_legacy": [[7, "upgrading-from-iocage-legacy"]], "Migrating from Ezjail to Iocage": [[7, "migrating-from-ezjail-to-iocage"]], "Create Target": [[7, "create-target"]], "Copy Old Data": [[7, "copy-old-data"]], "Populate iocage config.json": [[7, "populate-iocage-config-json"]], "Release": [[7, "release"]], "IP Address": [[7, "ip-address"]], "Start the New Jail": [[7, "start-the-new-jail"]], "(Optional) Update fstab": [[7, "optional-update-fstab"]], "iocage_cli package": [[8, "iocage-cli-package"]], "Submodules": [[8, "submodules"], [9, "submodules"], [17, "submodules"]], "iocage_cli.activate module": [[8, "module-iocage_cli.activate"]], "iocage_cli.chroot module": [[8, "module-iocage_cli.chroot"]], "iocage_cli.clean module": [[8, "module-iocage_cli.clean"]], "iocage_cli.clone module": [[8, "module-iocage_cli.clone"]], "iocage_cli.console module": [[8, "module-iocage_cli.console"]], "iocage_cli.create module": [[8, "module-iocage_cli.create"]], "iocage_cli.debug module": [[8, "module-iocage_cli.debug"]], "iocage_cli.destroy module": [[8, "module-iocage_cli.destroy"]], "iocage_cli.df module": [[8, "module-iocage_cli.df"]], "iocage_cli.exec module": [[8, "module-iocage_cli.exec"]], "iocage_cli.export module": [[8, "module-iocage_cli.export"]], "iocage_cli.fetch module": [[8, "module-iocage_cli.fetch"]], "iocage_cli.fstab module": [[8, "module-iocage_cli.fstab"]], "iocage_cli.get module": [[8, "module-iocage_cli.get"]], "iocage_cli.import module": [[8, "module-iocage_cli.import"]], "iocage_cli.list module": [[8, "module-iocage_cli.list"]], "iocage_cli.migrate module": [[8, "module-iocage_cli.migrate"]], "iocage_cli.pkg module": [[8, "module-iocage_cli.pkg"]], "iocage_cli.rename module": [[8, "module-iocage_cli.rename"]], "iocage_cli.restart module": [[8, "module-iocage_cli.restart"]], "iocage_cli.rollback module": [[8, "module-iocage_cli.rollback"]], "iocage_cli.set module": [[8, "module-iocage_cli.set"]], "iocage_cli.snaplist module": [[8, "module-iocage_cli.snaplist"]], "iocage_cli.snapremove module": [[8, "module-iocage_cli.snapremove"]], "iocage_cli.snapshot module": [[8, "module-iocage_cli.snapshot"]], "iocage_cli.start module": [[8, "module-iocage_cli.start"]], "iocage_cli.stop module": [[8, "module-iocage_cli.stop"]], "iocage_cli.update module": [[8, "module-iocage_cli.update"]], "iocage_cli.upgrade module": [[8, "module-iocage_cli.upgrade"]], "Module contents": [[8, "module-iocage_cli"], [9, "module-iocage_lib"], [17, "module-contents"]], "iocage_lib package": [[9, "iocage-lib-package"]], "iocage_lib.ioc_check module": [[9, "module-iocage_lib.ioc_check"]], "iocage_lib.ioc_clean module": [[9, "module-iocage_lib.ioc_clean"]], "iocage_lib.ioc_common module": [[9, "module-iocage_lib.ioc_common"]], "Parameters": [[9, "parameters"], [9, "id5"]], "iocage_lib.ioc_create module": [[9, "module-iocage_lib.ioc_create"]], "iocage_lib.ioc_debug module": [[9, "module-iocage_lib.ioc_debug"]], "iocage_lib.ioc_destroy module": [[9, "module-iocage_lib.ioc_destroy"]], "iocage_lib.ioc_exceptions module": [[9, "module-iocage_lib.ioc_exceptions"]], "iocage_lib.ioc_exec module": [[9, "module-iocage_lib.ioc_exec"]], "iocage_lib.ioc_fetch module": [[9, "module-iocage_lib.ioc_fetch"]], "iocage_lib.ioc_fstab module": [[9, "module-iocage_lib.ioc_fstab"]], "iocage_lib.ioc_image module": [[9, "module-iocage_lib.ioc_image"]], "iocage_lib.ioc_json module": [[9, "module-iocage_lib.ioc_json"]], "iocage_lib.ioc_list module": [[9, "module-iocage_lib.ioc_list"]], "iocage_lib.ioc_plugin module": [[9, "module-iocage_lib.ioc_plugin"]], "iocage_lib.ioc_start module": [[9, "module-iocage_lib.ioc_start"]], "iocage_lib.ioc_stop module": [[9, "module-iocage_lib.ioc_stop"]], "iocage_lib.ioc_upgrade module": [[9, "module-iocage_lib.ioc_upgrade"]], "iocage_lib.iocage module": [[9, "module-iocage_lib.iocage"]], "Jail Types": [[10, "jail-types"]], "Clone (default)": [[10, "clone-default"]], "Basejail": [[10, "basejail"]], "Template": [[10, "template"]], "Empty": [[10, "empty"]], "Thickjail": [[10, "thickjail"]], "Known Issues": [[11, "known-issues"]], "Mount Path Limit": [[11, "mount-path-limit"]], "VNET/VIMAGE Issues": [[11, "vnet-vimage-issues"]], "VNET/VIMAGE issues w/ ALTQ": [[11, "vnet-vimage-issues-w-altq"]], "IPv6 host bind failures": [[11, "ipv6-host-bind-failures"]], "iocage": [[12, "iocage"]], "Networking": [[13, "networking"]], "Shared IP": [[13, "shared-ip"]], "Using Shared IP": [[13, "using-shared-ip"]], "VIMAGE/VNET": [[13, "vimage-vnet"]], "Tips": [[13, "tips"]], "Configuring Network Interfaces": [[13, "configuring-network-interfaces"]], "Configuring a Shared IP Jail": [[13, "configuring-a-shared-ip-jail"]], "Configuring a VNET Jail": [[13, "configuring-a-vnet-jail"]], "Tips for Configuring VNET": [[13, "tips-for-configuring-vnet"]], "Plugins": [[14, "plugins"]], "setup module": [[15, "setup-module"]], "Using Templates": [[16, "using-templates"]], "tests package": [[17, "tests-package"]], "tests.conftest module": [[17, "tests-conftest-module"]], "tests.data_classes module": [[17, "tests-data-classes-module"]]}, "indexentries": {"advance usage": [[0, "index-0"]], "apply limits": [[0, "index-15"]], "auto-boot": [[0, "index-6"]], "automatic package installation": [[0, "index-18"]], "boot priority": [[0, "index-7"]], "check limits": [[0, "index-16"]], "clones": [[0, "index-1"]], "create clones": [[0, "index-2"]], "depends property": [[0, "index-8"]], "limit cpu usage by percentage": [[0, "index-17"]], "limit cores or threads": [[0, "index-11"]], "limit dram usage": [[0, "index-13"]], "list applied rules": [[0, "index-12"]], "promote a clone": [[0, "index-3"]], "resource limits": [[0, "index-10"]], "snapshot management": [[0, "index-9"]], "turn on resource limits": [[0, "index-14"]], "updating jails": [[0, "index-4"]], "upgrade jails": [[0, "index-5"]], "activate iocage": [[1, "index-2"]], "basic jail creation": [[1, "index-4"]], "basic usage": [[1, "index-0"]], "configure a jail": [[1, "index-10"]], "destroy a jail": [[1, "index-13"]], "fetch a release": [[1, "index-3"]], "get property": [[1, "index-12"]], "jail restart": [[1, "index-9"]], "jail start": [[1, "index-7"]], "jail stop": [[1, "index-8"]], "jail start stop restart": [[1, "index-6"]], "listing jails": [[1, "index-5"]], "rename jail": [[1, "index-14"]], "set property": [[1, "index-11"]], "setting environment variables": [[1, "index-1"]], "best practices": [[2, "index-0"]], "create debian jail": [[3, "index-0"]], "faq": [[4, "index-0"]], "fastentrypoints": [[5, "module-fastentrypoints"]], "get_args() (in module fastentrypoints)": [[5, "fastentrypoints.get_args"]], "main() (in module fastentrypoints)": [[5, "fastentrypoints.main"]], "module": [[5, "module-fastentrypoints"], [8, "module-iocage_cli"], [8, "module-iocage_cli.activate"], [8, "module-iocage_cli.chroot"], [8, "module-iocage_cli.clean"], [8, "module-iocage_cli.clone"], [8, "module-iocage_cli.console"], [8, "module-iocage_cli.create"], [8, "module-iocage_cli.debug"], [8, "module-iocage_cli.destroy"], [8, "module-iocage_cli.df"], [8, "module-iocage_cli.exec"], [8, "module-iocage_cli.export"], [8, "module-iocage_cli.fetch"], [8, "module-iocage_cli.fstab"], [8, "module-iocage_cli.get"], [8, "module-iocage_cli.import"], [8, "module-iocage_cli.list"], [8, "module-iocage_cli.migrate"], [8, "module-iocage_cli.pkg"], [8, "module-iocage_cli.rename"], [8, "module-iocage_cli.restart"], [8, "module-iocage_cli.rollback"], [8, "module-iocage_cli.set"], [8, "module-iocage_cli.snaplist"], [8, "module-iocage_cli.snapremove"], [8, "module-iocage_cli.snapshot"], [8, "module-iocage_cli.start"], [8, "module-iocage_cli.stop"], [8, "module-iocage_cli.update"], [8, "module-iocage_cli.upgrade"], [9, "module-iocage_lib"], [9, "module-iocage_lib.ioc_check"], [9, "module-iocage_lib.ioc_clean"], [9, "module-iocage_lib.ioc_common"], [9, "module-iocage_lib.ioc_create"], [9, "module-iocage_lib.ioc_debug"], [9, "module-iocage_lib.ioc_destroy"], [9, "module-iocage_lib.ioc_exceptions"], [9, "module-iocage_lib.ioc_exec"], [9, "module-iocage_lib.ioc_fetch"], [9, "module-iocage_lib.ioc_fstab"], [9, "module-iocage_lib.ioc_image"], [9, "module-iocage_lib.ioc_json"], [9, "module-iocage_lib.ioc_list"], [9, "module-iocage_lib.ioc_plugin"], [9, "module-iocage_lib.ioc_start"], [9, "module-iocage_lib.ioc_stop"], [9, "module-iocage_lib.ioc_upgrade"], [9, "module-iocage_lib.iocage"]], "ezjail migration": [[7, "index-1"]], "install iocage": [[7, "index-0"]], "ioclogger (class in iocage_cli)": [[8, "iocage_cli.IOCLogger"]], "iocagecli (class in iocage_cli)": [[8, "iocage_cli.IOCageCLI"]], "infohandler (class in iocage_cli)": [[8, "iocage_cli.InfoHandler"]], "child_test() (in module iocage_cli.destroy)": [[8, "iocage_cli.destroy.child_test"]], "emit() (iocage_cli.infohandler method)": [[8, "iocage_cli.InfoHandler.emit"]], "get_command() (iocage_cli.iocagecli method)": [[8, "iocage_cli.IOCageCLI.get_command"]], "iocage_cli": [[8, "module-iocage_cli"]], "iocage_cli.activate": [[8, "module-iocage_cli.activate"]], "iocage_cli.chroot": [[8, "module-iocage_cli.chroot"]], "iocage_cli.clean": [[8, "module-iocage_cli.clean"]], "iocage_cli.clone": [[8, "module-iocage_cli.clone"]], "iocage_cli.console": [[8, "module-iocage_cli.console"]], "iocage_cli.create": [[8, "module-iocage_cli.create"]], "iocage_cli.debug": [[8, "module-iocage_cli.debug"]], "iocage_cli.destroy": [[8, "module-iocage_cli.destroy"]], "iocage_cli.df": [[8, "module-iocage_cli.df"]], "iocage_cli.exec": [[8, "module-iocage_cli.exec"]], "iocage_cli.export": [[8, "module-iocage_cli.export"]], "iocage_cli.fetch": [[8, "module-iocage_cli.fetch"]], "iocage_cli.fstab": [[8, "module-iocage_cli.fstab"]], "iocage_cli.get": [[8, "module-iocage_cli.get"]], "iocage_cli.import": [[8, "module-iocage_cli.import"]], "iocage_cli.list": [[8, "module-iocage_cli.list"]], "iocage_cli.migrate": [[8, "module-iocage_cli.migrate"]], "iocage_cli.pkg": [[8, "module-iocage_cli.pkg"]], "iocage_cli.rename": [[8, "module-iocage_cli.rename"]], "iocage_cli.restart": [[8, "module-iocage_cli.restart"]], "iocage_cli.rollback": [[8, "module-iocage_cli.rollback"]], "iocage_cli.set": [[8, "module-iocage_cli.set"]], "iocage_cli.snaplist": [[8, "module-iocage_cli.snaplist"]], "iocage_cli.snapremove": [[8, "module-iocage_cli.snapremove"]], "iocage_cli.snapshot": [[8, "module-iocage_cli.snapshot"]], "iocage_cli.start": [[8, "module-iocage_cli.start"]], "iocage_cli.stop": [[8, "module-iocage_cli.stop"]], "iocage_cli.update": [[8, "module-iocage_cli.update"]], "iocage_cli.upgrade": [[8, "module-iocage_cli.upgrade"]], "list_commands() (iocage_cli.iocagecli method)": [[8, "iocage_cli.IOCageCLI.list_commands"]], "print_version() (in module iocage_cli)": [[8, "iocage_cli.print_version"]], "setconsoleloglevel() (iocage_cli.ioclogger method)": [[8, "iocage_cli.IOCLogger.setConsoleLogLevel"]], "validate_count() (in module iocage_cli.clone)": [[8, "iocage_cli.clone.validate_count"]], "validate_count() (in module iocage_cli.create)": [[8, "iocage_cli.create.validate_count"]], "validate_count() (in module iocage_cli.fetch)": [[8, "iocage_cli.fetch.validate_count"]], "commandfailed": [[9, "iocage_lib.ioc_exceptions.CommandFailed"]], "commandneedsroot": [[9, "iocage_lib.ioc_exceptions.CommandNeedsRoot"]], "default_props (iocage_lib.ioc_plugin.iocplugin attribute)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.DEFAULT_PROPS"]], "exceptionwithmsg": [[9, "iocage_lib.ioc_exceptions.ExceptionWithMsg"]], "exists": [[9, "iocage_lib.ioc_exceptions.Exists"]], "fstab (class in iocage_lib.ioc_fstab)": [[9, "iocage_lib.ioc_fstab.Fstab"]], "ioccheck (class in iocage_lib.ioc_check)": [[9, "iocage_lib.ioc_check.IOCCheck"]], "iocclean (class in iocage_lib.ioc_clean)": [[9, "iocage_lib.ioc_clean.IOCClean"]], "iocconfiguration (class in iocage_lib.ioc_json)": [[9, "iocage_lib.ioc_json.IOCConfiguration"]], "ioccpuset (class in iocage_lib.ioc_json)": [[9, "iocage_lib.ioc_json.IOCCpuset"]], "ioccreate (class in iocage_lib.ioc_create)": [[9, "iocage_lib.ioc_create.IOCCreate"]], "iocdebug (class in iocage_lib.ioc_debug)": [[9, "iocage_lib.ioc_debug.IOCDebug"]], "iocdestroy (class in iocage_lib.ioc_destroy)": [[9, "iocage_lib.ioc_destroy.IOCDestroy"]], "iocexec (class in iocage_lib.ioc_exec)": [[9, "iocage_lib.ioc_exec.IOCExec"]], "iocfetch (class in iocage_lib.ioc_fetch)": [[9, "iocage_lib.ioc_fetch.IOCFetch"]], "iocfstab (class in iocage_lib.ioc_fstab)": [[9, "iocage_lib.ioc_fstab.IOCFstab"]], "iocimage (class in iocage_lib.ioc_image)": [[9, "iocage_lib.ioc_image.IOCImage"]], "iocjson (class in iocage_lib.ioc_json)": [[9, "iocage_lib.ioc_json.IOCJson"]], "ioclist (class in iocage_lib.ioc_list)": [[9, "iocage_lib.ioc_list.IOCList"]], "iocplugin (class in iocage_lib.ioc_plugin)": [[9, "iocage_lib.ioc_plugin.IOCPlugin"]], "iocrctl (class in iocage_lib.ioc_json)": [[9, "iocage_lib.ioc_json.IOCRCTL"]], "iocstart (class in iocage_lib.ioc_start)": [[9, "iocage_lib.ioc_start.IOCStart"]], "iocstop (class in iocage_lib.ioc_stop)": [[9, "iocage_lib.ioc_stop.IOCStop"]], "iocupgrade (class in iocage_lib.ioc_upgrade)": [[9, "iocage_lib.ioc_upgrade.IOCUpgrade"]], "iocage (class in iocage_lib.iocage)": [[9, "iocage_lib.iocage.IOCage"]], "interactiveexec (class in iocage_lib.ioc_exec)": [[9, "iocage_lib.ioc_exec.InteractiveExec"]], "jailcorruptconfiguration": [[9, "iocage_lib.ioc_exceptions.JailCorruptConfiguration"]], "jailmisconfigured": [[9, "iocage_lib.ioc_exceptions.JailMisconfigured"]], "jailmissingconfiguration": [[9, "iocage_lib.ioc_exceptions.JailMissingConfiguration"]], "jailrunning": [[9, "iocage_lib.ioc_exceptions.JailRunning"]], "jailruntimeconfiguration (class in iocage_lib.ioc_json)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration"]], "plugin_version (iocage_lib.ioc_plugin.iocplugin attribute)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.PLUGIN_VERSION"]], "poolanddataset (class in iocage_lib.iocage)": [[9, "iocage_lib.iocage.PoolAndDataset"]], "poolnotactivated": [[9, "iocage_lib.ioc_exceptions.PoolNotActivated"]], "silentexec (class in iocage_lib.ioc_exec)": [[9, "iocage_lib.ioc_exec.SilentExec"]], "validationfailed": [[9, "iocage_lib.ioc_exceptions.ValidationFailed"]], "valuenotfound": [[9, "iocage_lib.ioc_exceptions.ValueNotFound"]], "activate() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.activate"]], "backup_iocage_jail_conf() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.backup_iocage_jail_conf"]], "boolean_prop_exists() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.boolean_prop_exists"]], "callback() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.callback"]], "check_aliases() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.check_aliases"]], "check_config() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.check_config"]], "check_default_config() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.check_default_config"]], "check_jail_config() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.check_jail_config"]], "check_release_newer() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.check_release_newer"]], "check_truthy() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.check_truthy"]], "checkoutput() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.checkoutput"]], "chroot() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.chroot"]], "clean() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.clean"]], "clean_all() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_all"]], "clean_debug() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_debug"]], "clean_images() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_images"]], "clean_jails() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_jails"]], "clean_releases() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_releases"]], "clean_templates() (iocage_lib.ioc_clean.iocclean method)": [[9, "iocage_lib.ioc_clean.IOCClean.clean_templates"]], "construct_truthy() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.construct_truthy"]], "consume_and_log() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.consume_and_log"]], "copytree() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.copytree"]], "create() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.create"]], "create_config() (iocage_lib.ioc_create.ioccreate method)": [[9, "iocage_lib.ioc_create.IOCCreate.create_config"]], "create_install_packages() (iocage_lib.ioc_create.ioccreate method)": [[9, "iocage_lib.ioc_create.IOCCreate.create_install_packages"]], "create_jail() (iocage_lib.ioc_create.ioccreate method)": [[9, "iocage_lib.ioc_create.IOCCreate.create_jail"]], "create_rc() (iocage_lib.ioc_create.ioccreate method)": [[9, "iocage_lib.ioc_create.IOCCreate.create_rc"]], "create_thickjail() (iocage_lib.ioc_create.ioccreate method)": [[9, "iocage_lib.ioc_create.IOCCreate.create_thickjail"]], "deactivate() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.deactivate"]], "debug() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.debug"]], "default_only_props (iocage_lib.ioc_json.iocjson attribute)": [[9, "iocage_lib.ioc_json.IOCJson.default_only_props"]], "destroy_jail() (iocage_lib.ioc_destroy.iocdestroy method)": [[9, "iocage_lib.ioc_destroy.IOCDestroy.destroy_jail"]], "destroy_jail() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.destroy_jail"]], "destroy_release() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.destroy_release"]], "df() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.df"]], "exec() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.exec"]], "exec_all() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.exec_all"]], "exec_jail() (iocage_lib.ioc_exec.iocexec method)": [[9, "iocage_lib.ioc_exec.IOCExec.exec_jail"]], "expand_abi_with_specified_release() (iocage_lib.ioc_plugin.iocplugin static method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.expand_abi_with_specified_release"]], "export() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.export"]], "export_jail() (iocage_lib.ioc_image.iocimage method)": [[9, "iocage_lib.ioc_image.IOCImage.export_jail"]], "fetch() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.fetch"]], "fetch_download() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.fetch_download"]], "fetch_extract() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.fetch_extract"]], "fetch_http_release() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.fetch_http_release"]], "fetch_plugin() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.fetch_plugin"]], "fetch_plugin_index() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.fetch_plugin_index"]], "fetch_plugin_packagesites() (iocage_lib.ioc_plugin.iocplugin static method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.fetch_plugin_packagesites"]], "fetch_plugin_versions() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.fetch_plugin_versions"]], "fetch_plugin_versions_from_plugin_index() (iocage_lib.ioc_plugin.iocplugin static method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.fetch_plugin_versions_from_plugin_index"]], "fetch_release() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.fetch_release"]], "fetch_update() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.fetch_update"]], "find_bridge_mtu() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.find_bridge_mtu"]], "fix_properties() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.fix_properties"]], "flight_checks() (iocage_lib.ioc_exec.iocexec method)": [[9, "iocage_lib.ioc_exec.IOCExec.flight_checks"]], "fs_file (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_file"]], "fs_freq (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_freq"]], "fs_mntops (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_mntops"]], "fs_passno (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_passno"]], "fs_spec (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_spec"]], "fs_type (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_type"]], "fs_vfstype (iocage_lib.ioc_fstab.fstab attribute)": [[9, "iocage_lib.ioc_fstab.Fstab.fs_vfstype"]], "fstab() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.fstab"]], "fstab_list() (iocage_lib.ioc_fstab.iocfstab method)": [[9, "iocage_lib.ioc_fstab.IOCFstab.fstab_list"]], "gen_nat_ip() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.gen_nat_ip"]], "gen_unused_lo_ip() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.gen_unused_lo_ip"]], "generate_devfs_ruleset() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.generate_devfs_ruleset"]], "get() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.get"]], "get_active_jails() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_active_jails"]], "get_bridge_members() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.get_bridge_members"]], "get_default_gateway() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.get_default_gateway"]], "get_default_interface() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.get_default_interface"]], "get_full_config() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.get_full_config"]], "get_host_gateways() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_host_gateways"]], "get_host_release() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_host_release"]], "get_iocroot() (iocage_lib.iocage.poolanddataset method)": [[9, "iocage_lib.iocage.PoolAndDataset.get_iocroot"]], "get_jail_freebsd_version() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_jail_freebsd_version"]], "get_jails_with_config() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_jails_with_config"]], "get_mac_prefix() (iocage_lib.ioc_json.iocconfiguration static method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.get_mac_prefix"]], "get_name_sortkey() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_name_sortkey"]], "get_natural_sortkey() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_natural_sortkey"]], "get_nested_key() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_nested_key"]], "get_pool() (iocage_lib.iocage.poolanddataset method)": [[9, "iocage_lib.iocage.PoolAndDataset.get_pool"]], "get_pool_and_iocroot() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.get_pool_and_iocroot"]], "get_size_sortkey() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_size_sortkey"]], "get_used_ips() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.get_used_ips"]], "get_version() (iocage_lib.ioc_json.iocconfiguration static method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.get_version"]], "ignore_exceptions() (in module iocage_lib.ioc_exceptions)": [[9, "iocage_lib.ioc_exceptions.ignore_exceptions"]], "import_() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.import_"]], "import_jail() (iocage_lib.ioc_image.iocimage method)": [[9, "iocage_lib.ioc_image.IOCImage.import_jail"]], "ioc_sort() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.ioc_sort"]], "iocage_lib": [[9, "module-iocage_lib"]], "iocage_lib.ioc_check": [[9, "module-iocage_lib.ioc_check"]], "iocage_lib.ioc_clean": [[9, "module-iocage_lib.ioc_clean"]], "iocage_lib.ioc_common": [[9, "module-iocage_lib.ioc_common"]], "iocage_lib.ioc_create": [[9, "module-iocage_lib.ioc_create"]], "iocage_lib.ioc_debug": [[9, "module-iocage_lib.ioc_debug"]], "iocage_lib.ioc_destroy": [[9, "module-iocage_lib.ioc_destroy"]], "iocage_lib.ioc_exceptions": [[9, "module-iocage_lib.ioc_exceptions"]], "iocage_lib.ioc_exec": [[9, "module-iocage_lib.ioc_exec"]], "iocage_lib.ioc_fetch": [[9, "module-iocage_lib.ioc_fetch"]], "iocage_lib.ioc_fstab": [[9, "module-iocage_lib.ioc_fstab"]], "iocage_lib.ioc_image": [[9, "module-iocage_lib.ioc_image"]], "iocage_lib.ioc_json": [[9, "module-iocage_lib.ioc_json"]], "iocage_lib.ioc_list": [[9, "module-iocage_lib.ioc_list"]], "iocage_lib.ioc_plugin": [[9, "module-iocage_lib.ioc_plugin"]], "iocage_lib.ioc_start": [[9, "module-iocage_lib.ioc_start"]], "iocage_lib.ioc_stop": [[9, "module-iocage_lib.ioc_stop"]], "iocage_lib.ioc_upgrade": [[9, "module-iocage_lib.ioc_upgrade"]], "iocage_lib.iocage": [[9, "module-iocage_lib.iocage"]], "json_check_prop() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_check_prop"]], "json_convert_from_ucl() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_convert_from_ucl"]], "json_convert_from_zfs() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_convert_from_zfs"]], "json_get_value() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_get_value"]], "json_load() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_load"]], "json_migrate_uuid_to_tag() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_migrate_uuid_to_tag"]], "json_plugin_get_value() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_plugin_get_value"]], "json_plugin_load() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_plugin_load"]], "json_plugin_set_value() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_plugin_set_value"]], "json_set_value() (iocage_lib.ioc_json.iocjson method)": [[9, "iocage_lib.ioc_json.IOCJson.json_set_value"]], "json_write() (iocage_lib.ioc_json.iocconfiguration method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.json_write"]], "list() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.list"]], "list_all() (iocage_lib.ioc_list.ioclist method)": [[9, "iocage_lib.ioc_list.IOCList.list_all"]], "list_all_quick() (iocage_lib.ioc_list.ioclist method)": [[9, "iocage_lib.ioc_list.IOCList.list_all_quick"]], "list_bases() (iocage_lib.ioc_list.ioclist method)": [[9, "iocage_lib.ioc_list.IOCList.list_bases"]], "list_datasets() (iocage_lib.ioc_list.ioclist method)": [[9, "iocage_lib.ioc_list.IOCList.list_datasets"]], "list_get_jid() (iocage_lib.ioc_list.ioclist class method)": [[9, "iocage_lib.ioc_list.IOCList.list_get_jid"]], "logit() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.logit"]], "lowercase_set() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.lowercase_set"]], "match_to_dir() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.match_to_dir"]], "normalize_data() (iocage_lib.ioc_json.jailruntimeconfiguration method)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration.normalize_data"]], "open_atomic() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.open_atomic"]], "parse_latest_release() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.parse_latest_release"]], "parse_package_name() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.parse_package_name"]], "path (iocage_lib.ioc_json.jailruntimeconfiguration property)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration.path"]], "pull_clone_git_repo() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.pull_clone_git_repo"]], "raise_sort_error() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.raise_sort_error"]], "rctl_rules_exist() (iocage_lib.ioc_json.iocrctl method)": [[9, "iocage_lib.ioc_json.IOCRCTL.rctl_rules_exist"]], "remove() (iocage_lib.ioc_json.jailruntimeconfiguration method)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration.remove"]], "remove_rctl_rules() (iocage_lib.ioc_json.iocrctl method)": [[9, "iocage_lib.ioc_json.IOCRCTL.remove_rctl_rules"]], "rename() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.rename"]], "reset_cache() (iocage_lib.iocage.iocage static method)": [[9, "iocage_lib.iocage.IOCage.reset_cache"]], "restart() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.restart"]], "retrieve_admin_portals() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.retrieve_admin_portals"]], "retrieve_cpu_sets() (iocage_lib.ioc_json.ioccpuset static method)": [[9, "iocage_lib.ioc_json.IOCCpuset.retrieve_cpu_sets"]], "retrieve_default_props() (iocage_lib.ioc_json.iocconfiguration static method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.retrieve_default_props"]], "retrieve_ip4_for_jail() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.retrieve_ip4_for_jail"]], "retrieve_plugin_index_data() (iocage_lib.ioc_plugin.iocplugin static method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.retrieve_plugin_index_data"]], "retrieve_plugin_json() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.retrieve_plugin_json"]], "rollback() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.rollback"]], "run_debug() (iocage_lib.ioc_debug.iocdebug method)": [[9, "iocage_lib.ioc_debug.IOCDebug.run_debug"]], "run_host_debug() (iocage_lib.ioc_debug.iocdebug method)": [[9, "iocage_lib.ioc_debug.IOCDebug.run_host_debug"]], "run_jail_debug() (iocage_lib.ioc_debug.iocdebug method)": [[9, "iocage_lib.ioc_debug.IOCDebug.run_jail_debug"]], "runscript() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.runscript"]], "set() (iocage_lib.ioc_json.jailruntimeconfiguration method)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration.set"]], "set() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.set"]], "set_cpuset() (iocage_lib.ioc_json.ioccpuset method)": [[9, "iocage_lib.ioc_json.IOCCpuset.set_cpuset"]], "set_interactive() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.set_interactive"]], "set_rcconf() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.set_rcconf"]], "set_rctl_rules() (iocage_lib.ioc_json.iocrctl method)": [[9, "iocage_lib.ioc_json.IOCRCTL.set_rctl_rules"]], "snap_list() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.snap_list"]], "snap_remove() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.snap_remove"]], "snapshot() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.snapshot"]], "sort_ava() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_ava"]], "sort_boot() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_boot"]], "sort_created() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_created"]], "sort_crt() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_crt"]], "sort_ip() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_ip"]], "sort_ip6() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_ip6"]], "sort_jid() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_jid"]], "sort_key() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_key"]], "sort_name() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_name"]], "sort_qta() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_qta"]], "sort_release() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_release"]], "sort_res() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_res"]], "sort_state() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_state"]], "sort_template() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_template"]], "sort_type() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_type"]], "sort_use() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.sort_use"]], "start() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.start"]], "start_copy_localtime() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_copy_localtime"]], "start_generate_resolv() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_generate_resolv"]], "start_network() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_network"]], "start_network_interface_vnet() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_network_interface_vnet"]], "start_network_vnet_addr() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_network_vnet_addr"]], "start_network_vnet_iface() (iocage_lib.ioc_start.iocstart method)": [[9, "iocage_lib.ioc_start.IOCStart.start_network_vnet_iface"]], "start_rc() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.start_rc"]], "stop() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.stop"]], "stop_rc() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.stop_rc"]], "sync_changes() (iocage_lib.ioc_json.jailruntimeconfiguration method)": [[9, "iocage_lib.ioc_json.JailRuntimeConfiguration.sync_changes"]], "tempfile() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.tempfile"]], "tmp_dataset_checks() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.tmp_dataset_checks"]], "truthy_inverse_values() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.truthy_inverse_values"]], "truthy_props (iocage_lib.ioc_json.iocjson attribute)": [[9, "iocage_lib.ioc_json.IOCJson.truthy_props"]], "truthy_values() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.truthy_values"]], "try_convert() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.try_convert"]], "types (iocage_lib.ioc_json.iocrctl attribute)": [[9, "iocage_lib.ioc_json.IOCRCTL.types"]], "update() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.update"]], "update() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.update"]], "update_all() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.update_all"]], "update_progress() (iocage_lib.ioc_fetch.iocfetch method)": [[9, "iocage_lib.ioc_fetch.IOCFetch.update_progress"]], "upgrade() (iocage_lib.ioc_plugin.iocplugin method)": [[9, "iocage_lib.ioc_plugin.IOCPlugin.upgrade"]], "upgrade() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.upgrade"]], "upgrade_all() (iocage_lib.iocage.iocage method)": [[9, "iocage_lib.iocage.IOCage.upgrade_all"]], "upgrade_basejail() (iocage_lib.ioc_upgrade.iocupgrade method)": [[9, "iocage_lib.ioc_upgrade.IOCUpgrade.upgrade_basejail"]], "upgrade_jail() (iocage_lib.ioc_upgrade.iocupgrade method)": [[9, "iocage_lib.ioc_upgrade.IOCUpgrade.upgrade_jail"]], "validate_cpuset_prop() (iocage_lib.ioc_json.ioccpuset static method)": [[9, "iocage_lib.ioc_json.IOCCpuset.validate_cpuset_prop"]], "validate_mac_prefix() (iocage_lib.ioc_json.iocconfiguration static method)": [[9, "iocage_lib.ioc_json.IOCConfiguration.validate_mac_prefix"]], "validate_plugin_manifest() (in module iocage_lib.ioc_common)": [[9, "iocage_lib.ioc_common.validate_plugin_manifest"]], "validate_rctl_props() (iocage_lib.ioc_json.iocrctl static method)": [[9, "iocage_lib.ioc_json.IOCRCTL.validate_rctl_props"]], "validate_rctl_tunable() (iocage_lib.ioc_json.iocrctl static method)": [[9, "iocage_lib.ioc_json.IOCRCTL.validate_rctl_tunable"]], "basejails": [[10, "index-2"]], "clone jails": [[10, "index-1"]], "empty jails": [[10, "index-4"]], "jail types": [[10, "index-0"]], "template jails": [[10, "index-3"]], "thickjail": [[10, "index-5"]], "ipv6 host bind failure": [[11, "index-4"]], "known issues": [[11, "index-0"], [11, "index-1"], [11, "index-2"], [11, "index-3"], [11, "index-4"]], "mount path limit": [[11, "index-1"]], "vnet and altq": [[11, "index-3"]], "vnet/vimage": [[11, "index-2"]], "configure network interfaces": [[13, "index-5"]], "configure shared ip jail": [[13, "index-6"]], "configure vnet jail": [[13, "index-7"]], "networking": [[13, "index-0"]], "shared ip": [[13, "index-1"]], "tips for configuring vnet": [[13, "index-8"]], "using shared ip": [[13, "index-2"]], "vimage_vnet": [[13, "index-3"]], "vnet tips": [[13, "index-4"]], "plugins": [[14, "index-0"]], "using templates": [[16, "index-0"]]}}) \ No newline at end of file +Search.setIndex({"docnames": ["advanced-use", "basic-use", "best-practices", "debian", "faq", "fastentrypoints", "index", "install", "iocage_cli", "iocage_lib", "jailtypes", "known-issues", "modules", "networking", "plugins", "setup", "templates", "tests"], "filenames": ["advanced-use.rst", "basic-use.rst", "best-practices.rst", "debian.rst", "faq.rst", "fastentrypoints.rst", "index.rst", "install.rst", "iocage_cli.rst", "iocage_lib.rst", "jailtypes.rst", "known-issues.rst", "modules.rst", "networking.rst", "plugins.rst", "setup.rst", "templates.rst", "tests.rst"], "titles": ["Advanced Usage", "Basic Usage", "Best Practices", "Create a Debian Buster Jail (native Linux)", "FAQ", "fastentrypoints module", "iocage - A FreeBSD Jail Manager", "Install iocage", "iocage_cli package", "iocage_lib package", "Jail Types", "Known Issues", "iocage", "Networking", "Plugins", "setup module", "Using Templates", "tests package"], "terms": {"when": [0, 1, 2, 7, 11, 13, 14], "i": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 16], "iocag": [0, 2, 3, 4, 10, 11, 13, 14, 16], "zf": [0, 3, 4, 6, 9, 10, 11], "filesystem": [0, 7, 9], "essenti": [0, 1, 4, 16], "ar": [0, 1, 2, 4, 7, 9, 10, 11, 13, 14, 16], "cheap": 0, "lightweight": 0, "writabl": [0, 4], "A": [0, 1, 4, 9, 13], "its": [0, 14, 16], "sourc": [0, 4, 7, 9], "To": [0, 1, 7, 11, 13, 14, 16], "destroi": [0, 6, 9, 11, 12], "preserv": [0, 10], "must": [0, 4, 7, 13, 14], "first": [0, 1, 9], "www01": [0, 1], "www02": [0, 1], "run": [0, 2, 3, 4, 7, 9, 11, 13, 14], "name": [0, 1, 2, 3, 4, 8, 9, 11, 13, 14, 16], "from": [0, 1, 2, 3, 5, 6, 9, 10, 11, 16], "an": [0, 1, 3, 4, 7, 8, 9, 10, 11, 13, 14], "exist": [0, 1, 7, 8, 9, 12, 16], "snapshotnam": 0, "www03": 0, "thi": [0, 1, 2, 3, 4, 5, 7, 8, 9, 10, 11, 13, 14, 16], "function": [0, 1, 9, 11, 14], "isn": [0, 7], "t": [0, 1, 7, 9, 10, 16], "fulli": [0, 4, 10, 13], "ad": [0, 1, 7, 11, 14], "mai": [0, 11], "expect": [0, 9], "uuid": [0, 1, 3, 4, 9, 11, 14, 16], "revers": 0, "relationship": 0, "The": [0, 1, 3, 7, 8, 9, 10, 13, 14, 16], "becom": [0, 4], "demot": 0, "can": [0, 1, 3, 4, 7, 9, 10, 11, 13, 14, 16], "now": [0, 1, 7], "remov": [0, 2, 7, 8, 9, 11, 12], "handl": [0, 13], "freebsd": [0, 1, 4, 7, 9, 11, 13, 14], "8": [0, 1, 3, 4, 6, 9], "util": 0, "while": [0, 9], "thei": [0, 8, 9, 10], "stop": [0, 2, 6, 7, 9, 11, 12, 16], "command": [0, 1, 2, 6, 7, 8, 9, 11, 14], "backup": 0, "given": [0, 1, 8, 9], "manual": [0, 1, 4, 13], "n": [0, 1, 2, 3, 7, 10, 16], "latest": [0, 1, 9, 14], "patch": [0, 1, 5, 9, 10], "level": [0, 8, 9, 14], "finish": [0, 2, 16], "appear": [0, 8], "properli": [0, 11], "snapremov": [0, 12], "test": [0, 1, 2, 3, 8, 10, 12, 13, 14], "without": [0, 11, 13], "affect": [0, 11], "same": [0, 1, 4, 9, 13, 14], "wai": [0, 4, 13], "outlin": 0, "abov": [0, 1, 7, 13], "testupd": 0, "flag": [0, 1, 11, 14], "option": [0, 1, 2, 8, 9, 11, 13], "assign": [0, 1, 4, 9, 11, 13], "By": [0, 1, 13], "default": [0, 1, 2, 4, 6, 7, 9, 13], "user": [0, 1, 2, 4, 9, 10, 11, 13, 14], "suppli": [0, 1, 9], "new": [0, 1, 9, 10, 16], "releas": [0, 2, 3, 6, 9, 10, 11, 13, 14, 16], "": [0, 1, 2, 3, 5, 7, 8, 9, 10, 11, 13, 14, 16], "For": [0, 1, 4, 9, 10, 13, 14], "exampl": [0, 1, 2, 3, 10, 11, 13, 14], "examplejail": [0, 10, 11, 13], "r": [0, 1, 2, 10, 13, 16], "11": [0, 1, 2, 7, 10, 13, 14, 16], "0": [0, 1, 2, 3, 7, 8, 9, 10, 11, 13, 14, 16], "tell": [0, 11], "It": [0, 2, 6, 7, 9, 10, 13, 14, 16], "recommend": [0, 2, 3, 16], "keep": 0, "host": [0, 2, 3, 4, 6, 7, 9, 10, 13], "synchron": [0, 10], "1": [0, 1, 3, 7, 9, 11, 13, 14], "method": [0, 7, 9, 14, 16], "also": [0, 1, 2, 3, 9, 13, 14], "basejail": [0, 1, 6, 7, 9], "make": [0, 4, 7, 9, 16], "sure": [0, 1, 4, 7, 9, 11, 13], "iocage_en": 0, "ye": [0, 2, 3, 4, 10, 16], "set": [0, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 16], "etc": [0, 2, 3, 7, 9, 11, 13], "rc": [0, 2, 9, 13], "conf": [0, 2, 9, 11, 13], "enabl": [0, 1, 3, 4, 11, 13], "dure": 0, "system": [0, 1, 4, 6, 7, 9, 11, 13, 14], "simpli": 0, "creation": [0, 1, 2, 9, 10, 11], "start": [0, 2, 3, 6, 9, 11, 12, 13, 14, 16], "after": [0, 1, 10, 13, 14], "order": [0, 8, 13], "specifi": [0, 1, 8, 9, 13, 14], "valu": [0, 1, 7, 8, 9, 14], "20": 0, "lower": 0, "higher": 0, "requir": [0, 1, 9, 10, 13, 16], "other": [0, 1, 7, 11, 13], "befor": [0, 1, 7, 9, 14], "one": [0, 1, 7, 9, 14], "space": [0, 10], "delimit": [0, 9], "wait": 0, "those": 0, "have": [0, 1, 9, 10, 13], "foo": [0, 9], "bar": [0, 9], "baz": 0, "support": [0, 4, 9, 10, 11, 13, 14], "transpar": [0, 6, 13], "out": [0, 4], "box": 0, "point": [0, 5], "time": [0, 1, 4, 10, 13, 16], "copi": [0, 4, 9, 10], "data": [0, 2, 9, 10], "safeti": 0, "which": [0, 1, 2, 13, 14, 16], "revert": 0, "ani": [0, 1, 7, 8, 9, 14, 16], "initi": [0, 1, 14], "take": [0, 8, 9, 11], "up": [0, 3, 7, 9, 13, 16], "almost": [0, 3], "chang": [0, 1, 2, 7, 9, 10, 14, 16], "record": [0, 8], "snaplist": [0, 9, 12], "base": [0, 1, 6, 8, 9, 10, 13, 16], "current": [0, 1, 7, 9, 11, 14], "avail": [0, 1, 11, 13, 14, 16], "version": [0, 4, 7, 8, 9], "yet": 0, "implement": [0, 8], "all": [0, 7, 9, 10, 14, 16], "subsect": 0, "procedur": 0, "here": [0, 1], "meant": [0, 1], "provid": [0, 1, 2, 9, 11], "singl": 0, "cpuset": 0, "tag": [0, 9], "4": [0, 1, 3, 9, 13], "gb": 0, "memori": [0, 4], "rss": 0, "done": [0, 1, 16], "fly": 0, "memoryus": [0, 9], "4g": 0, "deni": [0, 9], "rlimit": 0, "cap": 0, "activ": [0, 6, 9, 12, 14], "In": [0, 1, 3, 11, 13, 14], "testjail": [0, 2], "execut": [0, 7, 9, 11], "pcpu": [0, 9], "doubl": 0, "confirm": 0, "p": [0, 14], "pkglist": [0, 9], "need": [0, 1, 4, 7, 9, 10, 13, 14, 16], "json": [0, 9, 14], "file": [0, 1, 3, 7, 9, 11, 14], "contain": [0, 4, 6, 7, 9, 13, 14], "per": [0, 4, 9, 13], "line": [0, 1, 3, 7, 9, 11, 14], "internet": 0, "connect": [0, 13, 16], "pkg": [0, 3, 6, 9, 12, 14], "obtain": 0, "onlin": 0, "repositori": [0, 7], "add": [0, 3, 9, 11, 13, 14, 16], "nginx": [0, 16], "tmux": 0, "path": [0, 3, 6, 7, 9, 12, 14], "newli": [0, 1], "section": [1, 2, 3, 4, 10, 11, 13], "about": [1, 2, 9, 11, 13], "how": [1, 4, 14], "refer": [1, 4, 14], "rememb": [1, 3, 7, 16], "help": [1, 2], "alwai": [1, 2], "type": [1, 6, 7, 9, 11, 12, 14], "subcommand": [1, 8], "ha": [1, 2, 6, 9, 10, 11, 13, 16], "flow": 1, "us": [1, 2, 3, 4, 6, 9, 10, 11, 14], "As": [1, 11], "interact": [1, 9, 11], "guid": 1, "them": [1, 9], "through": 1, "experiment": [1, 10, 13], "color": 1, "mode": [1, 3, 9, 14], "iocage_color": 1, "true": [1, 3, 9], "four": 1, "accept": [1, 9], "descript": 1, "iocage_logfil": 1, "locat": [1, 7, 9], "log": [1, 8, 9], "fals": [1, 8, 9, 14], "turn": 1, "cli": [1, 8, 9, 11], "output": [1, 9], "iocage_forc": 1, "automat": [1, 6], "migrat": [1, 6, 9, 12], "iocage_plugin_ip": 1, "ip_addr": [1, 9], "plugin": [1, 6, 9], "quickli": [1, 10], "queri": 1, "anoth": [1, 7, 13, 16], "program": [1, 4, 14], "script": [1, 9], "process": [1, 3, 9, 11, 14, 16], "depend": [1, 8], "shell": [1, 9], "being": 1, "csh": 1, "tcsh": 1, "bash": 1, "sh": 1, "differ": [1, 10, 16], "slightli": 1, "setenv": 1, "export": [1, 6, 7, 9, 12], "link": [1, 7, 13], "usabl": 1, "zpool": [1, 9], "most": 1, "case": [1, 9, 11], "primari": 1, "more": [1, 2, 4, 6, 7, 11, 13], "advanc": [1, 6], "design": [1, 4], "onc": [0, 1, 2, 10, 16], "readi": 1, "abl": 1, "immedi": [1, 10], "begin": [1, 2], "download": [1, 9], "open": [1, 2, 9, 13, 14], "menu": 1, "choos": [1, 9], "seen": 1, "9": [1, 13], "3": [1, 9, 13, 14], "eol": [1, 9], "10": [1, 7, 11, 13], "2": [1, 4, 7, 9, 10, 13], "number": [1, 13], "desir": [1, 13], "press": 1, "enter": [1, 9], "select": 1, "exit": [1, 5, 8, 9], "quit": 1, "recent": [1, 11, 13], "appli": 1, "fine": [1, 2, 7], "tune": 1, "If": [1, 4, 7, 9, 11, 13, 14], "specif": [1, 10, 11, 13, 14, 16], "mirror": 1, "ftp": 1, "hostnam": [1, 9], "org": [1, 9, 14], "pull": 1, "directori": [1, 7, 8, 9], "d": 1, "dir": [1, 9], "With": 1, "There": [1, 2, 7, 11, 13], "two": 1, "normal": [1, 6, 14], "detail": [1, 4, 13], "found": [1, 7, 9, 10, 14], "document": [1, 4, 13], "adjust": [1, 14], "either": 1, "invok": 1, "b": [1, 10], "clone": [1, 4, 6, 7, 9, 12, 13], "multipl": [1, 4, 9, 10, 13], "c": [1, 5], "show": [1, 3, 9, 13, 14], "numer": 1, "simpl": [1, 7, 14], "myjail": [1, 13], "boot": [1, 6, 9, 11], "custom": [1, 2, 3, 4, 10, 16], "inform": [1, 7, 11, 13], "page": [1, 4, 6, 13], "access": [1, 9], "man": 1, "see": [1, 2, 9, 14], "view": [1, 14], "templat": [1, 2, 4, 6, 9], "down": [1, 7], "state": [1, 9], "statu": [1, 9, 13], "read": [1, 9, 11], "column": 1, "each": [1, 10, 14], "partial": 1, "entri": [1, 5, 7, 9], "long": [1, 9, 11], "charact": [1, 11], "enough": [1, 11], "identifi": [1, 2], "altern": [1, 11], "oper": [1, 4, 6, 7, 10], "complex": 1, "do": [1, 3, 4, 8], "like": [1, 3, 9, 11], "26e8e027": 1, "f00c": 1, "11e4": 1, "8f7f": 1, "3c970e80eb61": 1, "iocaget": 1, "www": 1, "26e8": 1, "syntax": [1, 6, 7], "alreadi": [1, 9, 14], "best": [1, 6, 7, 9], "Be": [1, 13], "note": [1, 2, 14, 16], "full": [1, 9, 14], "displai": [1, 4, 9], "irreversibli": 1, "allow": [1, 2, 4, 9, 11], "alter": 1, "jail1": 1, "testingjail": 1, "some": [2, 4, 6, 7, 11], "gener": [2, 4, 9, 13, 14], "guidelin": 2, "tip": 2, "work": [2, 4, 7, 11, 13], "manag": [2, 4, 7], "jail": [2, 4, 9, 11, 14, 16], "pf": [2, 4, 11], "modul": [2, 6, 12], "kernel": [2, 11, 13], "seem": 2, "vnet": [2, 3, 4, 6, 9], "bug": 2, "onli": [2, 4, 6, 9, 10, 11, 13], "trigger": 2, "directli": [2, 3, 13], "compil": [2, 11], "creat": [2, 4, 6, 9, 10, 12, 13, 14, 16], "avoid": 2, "mistak": 2, "easili": [2, 7, 14, 16], "properti": [2, 9, 10, 13, 14, 16], "someth": 2, "meaning": 2, "especi": 2, "infrequ": 2, "root": [2, 3, 7, 9, 14], "tester": 2, "been": 2, "updat": [2, 6, 9, 12, 14], "get": [2, 3, 9, 12, 13, 14], "control": [2, 13], "isol": [2, 13], "own": 2, "firewal": [2, 4], "known": [2, 6, 9, 13], "issu": [2, 6, 13], "discov": 2, "simplifi": [2, 4], "give": 2, "try": [2, 9], "restart": [2, 6, 9, 11, 12], "instead": 2, "perform": 2, "soft": [2, 9, 11], "leav": [2, 9, 16], "stack": [2, 4, 6, 9, 13], "alon": 2, "less": [2, 14], "stress": 2, "both": [2, 4, 11, 13], "check": [2, 4, 9, 13, 14], "rule": [2, 3, 9, 14], "ipfw": [2, 4, 11], "insid": [2, 4, 6, 9, 13], "put": 2, "firewall_en": 2, "firewall_typ": 2, "exclud": 2, "accident": 2, "block": 2, "right": [2, 9], "re": [2, 9], "lock": 2, "mix": [2, 9], "delet": [0, 2, 7, 9], "old": [2, 9], "snapshot": [2, 6, 9, 11, 12], "unnecessari": 2, "where": [2, 4, 10, 13, 14], "constantli": 2, "debjail": 3, "replac": [3, 7, 9, 13], "your": [3, 4, 7], "product": [3, 11], "intent": 3, "anyth": [3, 9], "empti": [3, 6, 7, 9], "e": [3, 7, 10, 13], "exec_start": 3, "bin": [3, 7], "exec_stop": 3, "instal": [3, 6, 9, 14, 16], "debootstrap": 3, "sysrc": [3, 13], "linux_en": 3, "linux_mounts_en": 3, "NO": 3, "servic": [3, 7, 11], "grab": 3, "mountpoint": [3, 7, 9, 11], "append": [3, 7], "apart": 3, "you": [0, 3, 4, 16], "ubuntu": 3, "eg": 3, "bionic": 3, "fstab": [3, 9, 10, 12], "edit": [3, 7], "devf": [3, 9, 14], "dev": 3, "rw": [3, 7], "tmpf": 3, "shm": 3, "size": [3, 9], "1g": 3, "1777": 3, "fdescf": 3, "fd": 3, "linrdlnk": 3, "linproc": 3, "proc": 3, "linprocf": 3, "linsi": 3, "sy": [3, 5], "linsysf": 3, "attach": [3, 4, 9], "consol": [3, 9, 12, 13], "result": 3, "64": [3, 13], "bit": 3, "userland": 3, "what": [4, 9, 14], "administr": 4, "task": 4, "o": 4, "virtual": [4, 6, 13], "technologi": [4, 6, 7], "term": 4, "zone": 4, "independ": [4, 10, 16], "network": [4, 6, 7, 9, 10, 16], "configur": [4, 6, 9, 14, 16], "interfac": [4, 6, 9, 11], "share": [4, 6], "ipjail": 4, "ip4_add": 4, "ip": [4, 6, 9, 14], "netmask": 4, "info": [4, 7], "pleas": [4, 14], "my": 4, "gatewai": [4, 9, 13], "address": [4, 9, 11, 13], "bridg": [4, 9, 13], "howev": [4, 7], "still": 4, "plan": 4, "securelevel": 4, "traffic": [4, 13], "thin": [4, 6], "provis": [4, 6], "too": [4, 11], "These": [4, 10, 13], "limit": [4, 6], "cpu": 4, "legaci": [4, 6], "resourc": [4, 6, 9, 13], "consumpt": 4, "df": [4, 9, 12], "nat": [4, 9, 14], "built": [4, 13], "treat": 4, "server": [4, 9], "core": [4, 14], "router": [4, 9], "chapter": 4, "Will": [4, 9], "pool": [4, 9], "No": [4, 16], "should": [4, 8, 14], "written": 6, "python": 6, "combin": 6, "featur": [6, 7], "offer": [6, 14], "gear": [6, 7], "eas": [6, 7], "simplist": 6, "easi": 6, "learn": 6, "rapid": 6, "within": [6, 7, 16], "second": [6, 16], "packag": [6, 12, 16], "non": 6, "dedic": 6, "dataset": [6, 9], "binari": 6, "import": [5, 6, 9, 12], "And": [6, 10], "mani": 6, "github": [5, 6, 14], "build": 6, "port": 6, "upgrad": [6, 9, 10, 12, 14], "iocage_legaci": 6, "ezjail": [6, 10], "basic": 6, "usag": [6, 9], "environ": [6, 10], "variabl": 6, "fetch": [6, 9, 12, 14], "list": [6, 7, 9, 10, 11, 12, 14, 16], "renam": [6, 9, 12], "vimag": 6, "thickjail": [6, 9], "practic": 6, "auto": [6, 13], "debian": 6, "buster": 6, "nativ": 6, "linux": [6, 10], "mount": [6, 7, 9, 10], "ipv6": [6, 9, 13], "bind": 6, "failur": 6, "faq": 6, "index": [6, 9], "search": 6, "merg": 7, "visit": 7, "sudo": 7, "py38": 7, "tree": [7, 9], "src_base": 7, "usr": 7, "src": [7, 9], "python38": 7, "git": 7, "lite": 7, "cython": 7, "libzf": 7, "pip": 7, "http": [5, 7, 9, 14], "com": [5, 7, 9, 14], "subsequ": 7, "possibl": 7, "pre": 7, "sysutil": 7, "py": 7, "cd": [7, 11], "clean": [7, 9, 12], "back": [7, 9, 13, 16], "onestart": 7, "assumpt": 7, "act": 7, "newjail": 7, "symlink": [7, 9], "reli": 7, "utlil": 7, "look": [7, 9], "l": 7, "oldjail": 7, "lrwxr": 7, "xr": 7, "x": [7, 9], "wheel": 7, "13": 7, "feb": 7, "22": 7, "2017": 7, "would": [7, 13], "doesn": [7, 9], "becaus": [7, 9], "ln": 7, "rsync": 7, "main": [5, 7, 8, 12], "part": 7, "via": 7, "grep": 7, "userland_vers": 7, "p6": 7, "goe": 7, "local": [7, 14], "jail_oldjail_ip": 7, "em0": [7, 13, 14], "192": [7, 13, 14], "168": [7, 13, 14], "ip4_addr": [7, 13, 14], "24": [7, 13], "subnet": [7, 9, 13], "mask": 7, "shut": 7, "so": [7, 8, 9, 16], "won": 7, "conflict": 7, "admin": 7, "well": [7, 9, 11], "cat": 7, "nullf": [7, 10], "ro": 7, "remain": [7, 16], "validate_count": [8, 12], "ctx": 8, "param": 8, "string": [8, 9], "comma": [8, 9], "return": [8, 9], "int": 8, "child_test": [8, 12], "iocroot": [8, 9], "_type": 8, "forc": [0, 8, 9, 13], "recurs": [8, 9], "children": [8, 9], "ioc": 8, "class": [8, 9], "ioclogg": [8, 12], "object": [8, 9, 14], "setconsoleloglevel": [8, 12], "iocagecli": [8, 12], "str": 8, "none": [8, 9, 13], "invoke_without_command": 8, "bool": [8, 9], "no_args_is_help": 8, "subcommand_metavar": 8, "chain": 8, "result_callback": 8, "callabl": [8, 9], "attr": 8, "multicommand": 8, "iter": [8, 9], "load": [8, 9], "definit": [8, 9], "get_command": [8, 12], "context": [8, 9], "list_command": [8, 12], "infohandl": [8, 12], "handler": 8, "emit": [8, 12], "whatev": 8, "actual": [8, 9], "intend": [8, 10], "subclass": 8, "rais": 8, "notimplementederror": 8, "print_vers": [8, 12], "print": 8, "ioccheck": [9, 12], "silent": 9, "callback": [9, 12], "reset_cach": [9, 12], "present": [9, 11], "iocclean": [9, 12], "clean_al": [9, 12], "everyth": [9, 13], "relat": 9, "clean_debug": [9, 12], "debug": [9, 12], "clean_imag": [9, 12], "imag": 9, "clean_jail": [9, 12], "respect": 9, "clean_releas": [9, 12], "clean_templ": [9, 12], "common": 9, "we": 9, "reus": 9, "boolean_prop_exist": [9, 12], "supplied_prop": 9, "props_to_check": 9, "_log": 9, "callback_except": 9, "helper": 9, "call": [9, 13], "appropri": [9, 10], "check_release_new": [9, 12], "raise_error": 9, "major_onli": 9, "greater": 9, "than": 9, "target": [0, 9], "check_truthi": [9, 12], "checkoutput": [9, 12], "arg": 9, "kwarg": 9, "just": [9, 16], "wrapper": 9, "utf": 9, "check_output": 9, "construct_truthi": [9, 12], "item": 9, "invers": 9, "truthi": 9, "variat": 9, "consume_and_log": [9, 12], "exec_gen": 9, "consum": [9, 10], "massag": 9, "copytre": [9, 12], "dst": 9, "ignor": 9, "overwrit": 9, "gen_nat_ip": [9, 12], "ip_prefix": 9, "effort": 9, "alloc": 9, "privat": 9, "gen_unused_lo_ip": [9, 12], "localhost": 9, "generate_devfs_ruleset": [9, 12], "includ": [3, 9, 14], "ruleset": [9, 14], "equal": 9, "devfs_ruleset": [9, 14], "get_active_jail": [9, 12], "get_host_gatewai": [9, 12], "get_host_releas": [9, 12], "sanit": 9, "get_jail_freebsd_vers": [9, 12], "get_jails_with_config": [9, 12], "filter": [9, 13], "mapping_func": 9, "get_name_sortkei": [9, 12], "get_natural_sortkei": [9, 12], "text": 9, "get_nested_kei": [9, 12], "_dict": 9, "kei": [9, 14], "nest": 9, "dictionari": [9, 14], "get_size_sortkei": [9, 12], "get_used_ip": [9, 12], "ifconfig": [9, 13], "everi": 9, "iterat": 9, "inus": 9, "ioc_sort": [9, 12], "caller": 9, "s_type": 9, "logit": [9, 12], "_callback": 9, "except": 9, "runtimeerror": 9, "our": 9, "lowercase_set": [9, 12], "match_to_dir": [9, 12], "old_uuid": 9, "dot": 9, "underscor": 9, "pattern": 9, "_": 9, "match": 9, "wa": [9, 10], "background": 9, "foo_bar": 9, "consid": [9, 13], "ident": 9, "cannot": [9, 13, 16], "coexist": 9, "open_atom": [9, 12], "filepath": 9, "temporari": 9, "atom": 9, "move": 9, "destin": 9, "upon": 9, "write": [5, 9], "filenam": 9, "fsync": 9, "whether": [9, 16], "disk": 9, "valid": [9, 14], "argument": [5, 9], "keyword": 9, "parse_latest_releas": [9, 12], "upstream": 9, "parse_package_nam": [9, 12], "raise_sort_error": [9, 12], "sort_list": 9, "retrieve_admin_port": [9, 12], "jail_run": 9, "admin_port": 9, "default_gatewai": 9, "full_ipv4_dict": 9, "retrieve_ip4_for_jail": [9, 12], "runscript": [9, 12], "custom_env": 9, "tupl": [5, 9], "stdout": 9, "last": 9, "stderr": 9, "set_interact": [9, 12], "tty": 9, "set_rcconf": [9, 12], "jail_path": 9, "sort_ava": [9, 12], "ava": 9, "sort": 9, "sort_boot": [9, 12], "sort_creat": [9, 12], "crt": 9, "sort_crt": [9, 12], "sort_ip": [9, 12], "sort_row": 9, "follow": [9, 13, 14], "dhcp": [9, 13, 14], "5": [9, 13], "accept_rtadv": 9, "obvious": 9, "forget": 9, "sort_ip6": [9, 12], "sort_jid": [9, 12], "jid": 9, "sort_kei": [9, 12], "sort_nam": [9, 12], "sort_qta": [9, 12], "qta": 9, "sort_releas": [9, 12], "split": 9, "fetch_releas": [9, 12], "sort_r": [9, 12], "rsize": 9, "sort_stat": [9, 12], "sort_templ": [9, 12], "sort_typ": [9, 12], "jail_typ": 9, "sort_us": [9, 12], "tempfil": [9, 12], "suffix": 9, "find": [9, 13, 16], "free": 9, "even": 9, "save": [9, 16], "tmp_dataset_check": [9, 12], "truthy_inverse_valu": [9, 12], "truthy_valu": [9, 12], "try_convert": [9, 12], "validate_plugin_manifest": [9, 12], "manifest": [9, 14], "ioccreat": [9, 12], "prop": 9, "num": 9, "config": 9, "short": [9, 11], "thickconfig": 9, "clone_basejail": 9, "create_config": [9, 12], "jail_uuid": 9, "source_templ": 9, "minim": 9, "self": 9, "create_install_packag": [9, 12], "repo": 9, "resolv": 9, "create_jail": [9, 12], "catch": 9, "sigint": 9, "create_rc": [9, 12], "host_hostnam": 9, "boilerpl": 9, "otherwis": [9, 11], "create_thickjail": [9, 12], "collect": 9, "iocdebug": [9, 12], "h": 9, "nsswitch": 9, "netstat": 9, "nr": 9, "run_debug": [9, 12], "run_host_debug": [9, 12], "run_jail_debug": [9, 12], "iocdestroi": [9, 12], "destroy_jail": [9, 12], "conveni": 9, "__stop_jails__": 9, "__destroy_parse_datasets__": 9, "commandfail": [9, 12], "messag": 9, "exceptionwithmsg": [9, 12], "commandneedsroot": [9, 12], "attribut": 9, "jailcorruptconfigur": [9, 12], "jailmisconfigur": [9, 12], "jailmissingconfigur": [9, 12], "jailrun": [9, 12], "poolnotactiv": [9, 12], "validationfail": [9, 12], "valuenotfound": [9, 12], "ignore_except": [9, 12], "suppress_except": 9, "exec": [9, 12, 13], "iocexec": [9, 12], "host_us": 9, "jail_us": 9, "unjail": 9, "skip": 9, "stdin_bytestr": 9, "su_env": 9, "decod": 9, "jexec": 9, "exec_jail": [9, 12], "flight_check": [9, 12], "interactiveexec": [9, 12], "silentexec": [9, 12], "iocfetch": [9, 12], "anonym": 9, "password": 9, "auth": 9, "root_dir": 9, "_file": 9, "verifi": [9, 13], "harden": 9, "txz": 9, "lib32": 9, "fetch_download": [9, 12], "_list": 9, "miss": 9, "fetch_extract": [9, 12], "f": [0, 9], "dest": 9, "fetch_http_releas": [9, 12], "xx": 9, "small": [9, 10], "fetch_upd": [9, 12], "update_progress": [9, 12], "progress": 9, "display_text": 9, "elaps": 9, "chunk_siz": 9, "origin": [9, 10], "stackoverflow": 9, "15860757": 9, "1391441": 9, "manipul": 9, "structur": [9, 14], "fs_file": [9, 12], "union": 9, "member": [9, 13], "fs_freq": [9, 12], "fs_mntop": [9, 12], "fs_passno": [9, 12], "fs_spec": [9, 12], "fs_type": [9, 12], "fs_vfstype": [9, 12], "iocfstab": [9, 12], "action": 9, "fstype": 9, "fsoption": 9, "fsdump": 9, "fspass": 9, "header": 9, "umount": 9, "fstab_list": [9, 12], "tabl": 9, "iocimag": [9, 12], "export_jail": [9, 12], "compression_algo": 9, "zip": 9, "import_jail": [9, 12], "convert": [9, 10, 16], "iocconfigur": [9, 12], "checking_dataset": 9, "backup_iocage_jail_conf": [9, 12], "check_config": [9, 12], "input": 9, "check_default_config": [9, 12], "check_jail_config": [9, 12], "fix_properti": [9, 12], "bad": 9, "previous": [9, 13], "fix": 9, "correct": 9, "equival": 9, "aren": 9, "config_vers": 9, "bump": 9, "static": 9, "get_mac_prefix": [9, 12], "get_pool_and_iocroot": [9, 12], "intern": 9, "get_vers": [9, 12], "json_writ": [9, 12], "retrieve_default_prop": [9, 12], "validate_mac_prefix": [9, 12], "mac_prefix": 9, "ioccpuset": [9, 12], "retrieve_cpu_set": [9, 12], "set_cpuset": [9, 12], "validate_cpuset_prop": [9, 12], "iocjson": [9, 12], "suppress_log": 9, "ucl": 9, "format": [5, 9], "default_only_prop": [9, 12], "nat_prefix": 9, "nat_interfac": 9, "nat_backend": 9, "get_full_config": [9, 12], "json_check_prop": [9, 12], "good": 9, "json_convert_from_ucl": [9, 12], "json_convert_from_zf": [9, 12], "json_get_valu": [9, 12], "json_load": [9, 12], "json_migrate_uuid_to_tag": [9, 12], "json_plugin_get_valu": [9, 12], "json_plugin_load": [9, 12], "json_plugin_set_valu": [9, 12], "json_set_valu": [9, 12], "_import": 9, "truthy_prop": [9, 12], "bpf": [3, 9, 14], "host_tim": 9, "rtsold": 9, "jail_zf": 9, "hostid_strict_check": 9, "exec_clean": 9, "mount_linprocf": 9, "mount_procf": 9, "allow_vmm": 9, "allow_tun": 9, "allow_socket_af": [3, 9], "allow_quota": 9, "allow_mount_zf": 9, "allow_mount_tmpf": 9, "allow_mount_procf": 9, "allow_mount_nullf": 9, "allow_mount_fusef": 9, "allow_mount_devf": [3, 9], "allow_mount_fdescf": 9, "allow_mount": [3, 9], "allow_mlock": 9, "allow_chflag": 9, "allow_raw_socket": [3, 9], "allow_sysvipc": 9, "allow_set_hostnam": 9, "mount_fdescf": 9, "mount_devf": 9, "ip6_saddrsel": 9, "ip4_saddrsel": 9, "ip_hostnam": 9, "assign_localhost": 9, "iocrctl": [9, 12], "rctl_rules_exist": [9, 12], "remove_rctl_rul": [9, 12], "set_rctl_rul": [9, 12], "coredumps": 9, "cputim": 9, "datas": 9, "maxproc": 9, "memorylock": 9, "msgqqueu": 9, "msgqsize": 9, "nmsgq": 9, "nsem": 9, "nsemop": 9, "nshm": 9, "nthr": 9, "openfil": 9, "pseudotermin": 9, "readbp": 9, "readiop": 9, "shmsize": 9, "stacksiz": 9, "swapus": 9, "vmemoryus": 9, "wallclock": 9, "writebp": 9, "writeiop": 9, "validate_rctl_prop": [9, 12], "validate_rctl_tun": [9, 12], "jailruntimeconfigur": [9, 12], "jail_nam": 9, "normalize_data": [9, 12], "sync_chang": [9, 12], "ioclist": [9, 12], "lst_type": 9, "hdr": 9, "_sort": 9, "quick": 9, "uid": 9, "ip4": 9, "list_al": [9, 12], "list_all_quick": [9, 12], "list_bas": [9, 12], "list_dataset": [9, 12], "classmethod": 9, "list_get_jid": [9, 12], "id": 9, "iocplugin": [9, 12], "branch": 9, "keep_jail_on_failur": 9, "respons": 9, "life": 9, "cycl": 9, "default_prop": [9, 12], "plugin_vers": [9, 12], "expand_abi_with_specified_releas": [9, 12], "packagesit": [9, 14], "fetch_plugin": [9, 12], "accept_licens": 9, "fetch_plugin_index": [9, 12], "list_head": 9, "list_long": 9, "icon": [9, 14], "offici": [9, 14], "index_onli": 9, "fetch_plugin_packagesit": [9, 12], "package_sit": 9, "fetch_plugin_vers": [9, 12], "fetch_plugin_versions_from_plugin_index": [9, 12], "plugins_index": 9, "pull_clone_git_repo": [9, 12], "depth": [9, 13], "retrieve_plugin_index_data": [9, 12], "plugin_index_path": 9, "expand_abi": 9, "retrieve_plugin_json": [9, 12], "start_rc": [9, 12], "stop_rc": [9, 12], "iocstart": [9, 12], "is_depend": 9, "unit_test": 9, "used_port": 9, "exec_": 9, "check_alias": [9, 12], "alia": [9, 13], "find_bridge_mtu": [9, 12], "get_bridge_memb": [9, 12], "get_default_gatewai": [9, 12], "address_famili": 9, "ipv4": [9, 13], "get_default_interfac": [9, 12], "start_copy_localtim": [9, 12], "start_generate_resolv": [9, 12], "start_network": [9, 12], "larg": [9, 10], "pass": [9, 13], "boolean": 9, "start_network_interface_vnet": [9, 12], "nic_def": 9, "net_config": 9, "nat_addr": 9, "separ": [9, 13], "nic": 9, "pair": 9, "start_network_vnet_addr": [9, 12], "ifac": 9, "defaultgw": 9, "error": 9, "occur": [9, 13], "start_network_vnet_ifac": [9, 12], "mtu": 9, "real": 9, "meat": 9, "potato": 9, "iocstop": [9, 12], "unmount": 9, "iocupgrad": [9, 12], "new_releas": 9, "upgrade_basejail": [9, 12], "snap_nam": 9, "upgrade_jail": [9, 12], "skip_jail": 9, "chroot": [9, 12], "deprec": 9, "d_type": 9, "count": 9, "_uuid": 9, "skip_batch": 9, "deactiv": [9, 12], "reduc": 9, "perfom": 9, "hit": 9, "destroy_releas": [9, 12], "ask": 9, "start_jail": 9, "msg_return": 9, "exec_al": [9, 12], "dump": 9, "_pass": 9, "add_path": 9, "import_": [9, 12], "new_nam": 9, "rollback": [9, 11, 12], "roll": 9, "snap_list": [9, 12], "gather": 9, "snap_remov": [9, 12], "patchset": 9, "update_al": [9, 12], "upgrade_al": [9, 12], "poolanddataset": [9, 12], "get_iocroot": [9, 12], "get_pool": [9, 12], "sever": 10, "benefit": 10, "drawback": 10, "serv": [10, 13], "varieti": 10, "uniqu": [10, 11], "describ": 10, "duplic": [10, 11], "amount": 10, "concept": 10, "popular": [10, 14], "littl": 10, "startup": 10, "ideal": 10, "further": 10, "satisfi": 10, "newexamplejail": 10, "unsupport": 10, "setup": [10, 12], "transmiss": [10, 13], "between": [10, 11, 13, 16], "send": 10, "receiv": 10, "length": 11, "histor": 11, "88": 11, "doe": [11, 13], "challeng": 11, "dive": 11, "tar": 11, "around": 11, "shorten": 11, "caus": [11, 13], "unexpect": [11, 13], "crash": [11, 13], "word": 11, "kill": 11, "workaround": 11, "stabl": 11, "machin": 11, "over": [11, 13], "100": [11, 14], "dai": 11, "uptim": 11, "p10": 11, "interest": 11, "queue": 11, "rout": [11, 13], "softwar": 11, "kernconf": 11, "unless": 11, "disabl": [11, 13], "altq_cbq": 11, "altq_r": 11, "altq_rio": 11, "altq_hfsc": 11, "altq_cdnr": 11, "altq_priq": 11, "2014": 11, "mail": 11, "post": 11, "ip6": 11, "defin": 11, "fail": 11, "happen": 11, "sysctl": [11, 13], "dad": 11, "detect": 11, "probe": 11, "packet": [11, 13], "net": [11, 13], "inet6": 11, "dad_count": 11, "perman": 11, "2013": 11, "fastentrypoint": 12, "iocage_cli": 12, "submodul": 12, "content": [12, 16], "iocage_lib": 12, "ioc_check": 12, "ioc_clean": 12, "ioc_common": 12, "ioc_creat": 12, "ioc_debug": 12, "ioc_destroi": 12, "ioc_except": 12, "ioc_exec": 12, "ioc_fetch": 12, "ioc_fstab": 12, "ioc_imag": 12, "ioc_json": 12, "ioc_list": 12, "ioc_plugin": 12, "ioc_start": 12, "ioc_stop": 12, "ioc_upgrad": 12, "conftest": 12, "data_class": 12, "better": [5, 13], "tradition": 13, "commun": 13, "typic": 13, "develop": [13, 14], "sometim": 13, "abstract": 13, "behav": 13, "physic": 13, "instruct": 13, "rest": 13, "along": 13, "adapt": 13, "placehold": 13, "comput": 13, "hardwar": 13, "compon": 13, "rock": 13, "solid": 13, "decad": 13, "heavi": 13, "few": 13, "step": 13, "examplejail1": 13, "off": 13, "direct": 13, "visibl": 13, "sctp": 13, "rebuild": 13, "nooption": 13, "stream": 13, "protocol": 13, "racct": 13, "rctl": 13, "On": 13, "node": 13, "cloned_interfac": 13, "bridge0": 13, "plumb": 13, "ifconfig_bridge0": 13, "addm": 13, "ifconfig_em0": 13, "tunabl": 13, "inet": 13, "forward": 13, "pfil_onlyip": 13, "pfil": 13, "pfil_bridg": 13, "pfil_memb": 13, "defaultrout": 13, "254": 13, "vnet0": 13, "ping": 13, "know": [13, 16], "vlan": 13, "parent": 13, "vlans_em0": 13, "666": 13, "ifconfig_em0_666": 13, "vnet_default_interfac": 13, "vnet1": 13, "bridge1": 13, "hand": 13, "ip6_addr": 13, "2001": 13, "123": 13, "456": 13, "242": 13, "defaultrouter6": 13, "impli": 13, "berklei": 13, "6": [3, 13], "regener": 13, "mac": 13, "hw": 13, "g": 13, "next": 13, "vnet0_mac": 13, "veri": 14, "fast": [5, 14], "applic": 14, "At": 14, "repeatedli": 14, "addition": 14, "extend": 14, "high": 14, "customiz": 14, "consist": 14, "png": 14, "pr": 14, "remot": 14, "modifi": [14, 16], "IF": 14, "manner": 14, "plexmediaserv": 14, "igb0": 14, "91": 14, "re0": 14, "individu": 14, "quasselcor": 14, "complet": 14, "freena": 14, "50": 14, "hello": 14, "world": 14, "exactli": 14, "default_jail_name_her": 14, "artifact": 14, "git_path_to_plugin_repo": 14, "nat_forward": 14, "tcp": 14, "7878": 14, "null": 14, "abi": 14, "fingerprint": 14, "sha256": 14, "b0170035af3acc5f3f3ae1859dc717101b4e6c1d0a794ad554928ca0cbb2f438": 14, "revis": 14, "translat": 14, "unhid": [3, 14], "dynam": 14, "ruleset_numb": 14, "include_valu": 14, "preciou": 16, "preconfigur": 16, "deploy": 16, "mytempl": 16, "php": 16, "jailfromtempl": 16, "sinc": 16, "wish": 16, "unaffect": 16, "thick": 16, "newtempl": 16, "get_arg": [5, 12], "monkei": 5, "setuptool": 5, "faster": 5, "console_script": 5, "mymodul": 5, "entry_funct": 5, "2016": 5, "aaron": 5, "christianson": 5, "ninjaaron": 5, "entry_point": 5, "implicit": [], "instanc": [], "declar": [], "idiom": [], "def": [], "cl": [], "arg1": [], "arg2": [], "deriv": [], "java": [], "want": 0, "staticmethod": [], "builtin": [], "allow_mount_linprocf": [3, 9], "allow_nfsd": 9, "devfsrules_jail_linux": 3, "devfsrules_hide_al": 3, "devfsrules_unhide_bas": 3, "devfsrules_unhide_login": 3, "tun": 3, "bookworm": 3, "allow_mount_linsysf": [3, 9], "yield": 5, "write_script": 5, "distribut": 5, "gui_script": 5}, "objects": {"": [[5, 0, 0, "-", "fastentrypoints"], [8, 0, 0, "-", "iocage_cli"], [9, 0, 0, "-", "iocage_lib"]], "fastentrypoints": [[5, 1, 1, "", "get_args"], [5, 1, 1, "", "main"]], "iocage_cli": [[8, 2, 1, "", "IOCLogger"], [8, 2, 1, "", "IOCageCLI"], [8, 2, 1, "", "InfoHandler"], [8, 0, 0, "-", "activate"], [8, 0, 0, "-", "chroot"], [8, 0, 0, "-", "clean"], [8, 0, 0, "-", "clone"], [8, 0, 0, "-", "console"], [8, 0, 0, "-", "create"], [8, 0, 0, "-", "debug"], [8, 0, 0, "-", "destroy"], [8, 0, 0, "-", "df"], [8, 0, 0, "-", "exec"], [8, 0, 0, "-", "export"], [8, 0, 0, "-", "fetch"], [8, 0, 0, "-", "fstab"], [8, 0, 0, "-", "get"], [8, 0, 0, "-", "import"], [8, 0, 0, "-", "list"], [8, 0, 0, "-", "migrate"], [8, 0, 0, "-", "pkg"], [8, 1, 1, "", "print_version"], [8, 0, 0, "-", "rename"], [8, 0, 0, "-", "restart"], [8, 0, 0, "-", "rollback"], [8, 0, 0, "-", "set"], [8, 0, 0, "-", "snaplist"], [8, 0, 0, "-", "snapremove"], [8, 0, 0, "-", "snapshot"], [8, 0, 0, "-", "start"], [8, 0, 0, "-", "stop"], [8, 0, 0, "-", "update"], [8, 0, 0, "-", "upgrade"]], "iocage_cli.IOCLogger": [[8, 3, 1, "", "setConsoleLogLevel"]], "iocage_cli.IOCageCLI": [[8, 3, 1, "", "get_command"], [8, 3, 1, "", "list_commands"]], "iocage_cli.InfoHandler": [[8, 3, 1, "", "emit"]], "iocage_cli.clone": [[8, 1, 1, "", "validate_count"]], "iocage_cli.create": [[8, 1, 1, "", "validate_count"]], "iocage_cli.destroy": [[8, 1, 1, "", "child_test"]], "iocage_cli.fetch": [[8, 1, 1, "", "validate_count"]], "iocage_lib": [[9, 0, 0, "-", "ioc_check"], [9, 0, 0, "-", "ioc_clean"], [9, 0, 0, "-", "ioc_common"], [9, 0, 0, "-", "ioc_create"], [9, 0, 0, "-", "ioc_debug"], [9, 0, 0, "-", "ioc_destroy"], [9, 0, 0, "-", "ioc_exceptions"], [9, 0, 0, "-", "ioc_exec"], [9, 0, 0, "-", "ioc_fetch"], [9, 0, 0, "-", "ioc_fstab"], [9, 0, 0, "-", "ioc_image"], [9, 0, 0, "-", "ioc_json"], [9, 0, 0, "-", "ioc_list"], [9, 0, 0, "-", "ioc_plugin"], [9, 0, 0, "-", "ioc_start"], [9, 0, 0, "-", "ioc_stop"], [9, 0, 0, "-", "ioc_upgrade"], [9, 0, 0, "-", "iocage"]], "iocage_lib.ioc_check": [[9, 2, 1, "", "IOCCheck"]], "iocage_lib.ioc_clean": [[9, 2, 1, "", "IOCClean"]], "iocage_lib.ioc_clean.IOCClean": [[9, 3, 1, "", "clean_all"], [9, 3, 1, "", "clean_debug"], [9, 3, 1, "", "clean_images"], [9, 3, 1, "", "clean_jails"], [9, 3, 1, "", "clean_releases"], [9, 3, 1, "", "clean_templates"]], "iocage_lib.ioc_common": [[9, 1, 1, "", "boolean_prop_exists"], [9, 1, 1, "", "callback"], [9, 1, 1, "", "check_release_newer"], [9, 1, 1, "", "check_truthy"], [9, 1, 1, "", "checkoutput"], [9, 1, 1, "", "construct_truthy"], [9, 1, 1, "", "consume_and_log"], [9, 1, 1, "", "copytree"], [9, 1, 1, "", "gen_nat_ip"], [9, 1, 1, "", "gen_unused_lo_ip"], [9, 1, 1, "", "generate_devfs_ruleset"], [9, 1, 1, "", "get_active_jails"], [9, 1, 1, "", "get_host_gateways"], [9, 1, 1, "", "get_host_release"], [9, 1, 1, "", "get_jail_freebsd_version"], [9, 1, 1, "", "get_jails_with_config"], [9, 1, 1, "", "get_name_sortkey"], [9, 1, 1, "", "get_natural_sortkey"], [9, 1, 1, "", "get_nested_key"], [9, 1, 1, "", "get_size_sortkey"], [9, 1, 1, "", "get_used_ips"], [9, 1, 1, "", "ioc_sort"], [9, 1, 1, "", "logit"], [9, 1, 1, "", "lowercase_set"], [9, 1, 1, "", "match_to_dir"], [9, 1, 1, "", "open_atomic"], [9, 1, 1, "", "parse_latest_release"], [9, 1, 1, "", "parse_package_name"], [9, 1, 1, "", "raise_sort_error"], [9, 1, 1, "", "retrieve_admin_portals"], [9, 1, 1, "", "retrieve_ip4_for_jail"], [9, 1, 1, "", "runscript"], [9, 1, 1, "", "set_interactive"], [9, 1, 1, "", "set_rcconf"], [9, 1, 1, "", "sort_ava"], [9, 1, 1, "", "sort_boot"], [9, 1, 1, "", "sort_created"], [9, 1, 1, "", "sort_crt"], [9, 1, 1, "", "sort_ip"], [9, 1, 1, "", "sort_ip6"], [9, 1, 1, "", "sort_jid"], [9, 1, 1, "", "sort_key"], [9, 1, 1, "", "sort_name"], [9, 1, 1, "", "sort_qta"], [9, 1, 1, "", "sort_release"], [9, 1, 1, "", "sort_res"], [9, 1, 1, "", "sort_state"], [9, 1, 1, "", "sort_template"], [9, 1, 1, "", "sort_type"], [9, 1, 1, "", "sort_use"], [9, 1, 1, "", "tempfile"], [9, 1, 1, "", "tmp_dataset_checks"], [9, 1, 1, "", "truthy_inverse_values"], [9, 1, 1, "", "truthy_values"], [9, 1, 1, "", "try_convert"], [9, 1, 1, "", "validate_plugin_manifest"]], "iocage_lib.ioc_create": [[9, 2, 1, "", "IOCCreate"]], "iocage_lib.ioc_create.IOCCreate": [[9, 3, 1, "", "create_config"], [9, 3, 1, "", "create_install_packages"], [9, 3, 1, "", "create_jail"], [9, 3, 1, "", "create_rc"], [9, 3, 1, "", "create_thickjail"]], "iocage_lib.ioc_debug": [[9, 2, 1, "", "IOCDebug"]], "iocage_lib.ioc_debug.IOCDebug": [[9, 3, 1, "", "run_debug"], [9, 3, 1, "", "run_host_debug"], [9, 3, 1, "", "run_jail_debug"]], "iocage_lib.ioc_destroy": [[9, 2, 1, "", "IOCDestroy"]], "iocage_lib.ioc_destroy.IOCDestroy": [[9, 3, 1, "", "destroy_jail"]], "iocage_lib.ioc_exceptions": [[9, 4, 1, "", "CommandFailed"], [9, 4, 1, "", "CommandNeedsRoot"], [9, 4, 1, "", "ExceptionWithMsg"], [9, 4, 1, "", "Exists"], [9, 4, 1, "", "JailCorruptConfiguration"], [9, 4, 1, "", "JailMisconfigured"], [9, 4, 1, "", "JailMissingConfiguration"], [9, 4, 1, "", "JailRunning"], [9, 4, 1, "", "PoolNotActivated"], [9, 4, 1, "", "ValidationFailed"], [9, 4, 1, "", "ValueNotFound"], [9, 1, 1, "", "ignore_exceptions"]], "iocage_lib.ioc_exec": [[9, 2, 1, "", "IOCExec"], [9, 2, 1, "", "InteractiveExec"], [9, 2, 1, "", "SilentExec"]], "iocage_lib.ioc_exec.IOCExec": [[9, 3, 1, "", "exec_jail"], [9, 3, 1, "", "flight_checks"]], "iocage_lib.ioc_fetch": [[9, 2, 1, "", "IOCFetch"]], "iocage_lib.ioc_fetch.IOCFetch": [[9, 3, 1, "", "fetch_download"], [9, 3, 1, "", "fetch_extract"], [9, 3, 1, "", "fetch_http_release"], [9, 3, 1, "", "fetch_release"], [9, 3, 1, "", "fetch_update"], [9, 3, 1, "", "update_progress"]], "iocage_lib.ioc_fstab": [[9, 2, 1, "", "Fstab"], [9, 2, 1, "", "IOCFstab"]], "iocage_lib.ioc_fstab.Fstab": [[9, 5, 1, "", "fs_file"], [9, 5, 1, "", "fs_freq"], [9, 5, 1, "", "fs_mntops"], [9, 5, 1, "", "fs_passno"], [9, 5, 1, "", "fs_spec"], [9, 5, 1, "", "fs_type"], [9, 5, 1, "", "fs_vfstype"]], "iocage_lib.ioc_fstab.IOCFstab": [[9, 3, 1, "", "fstab_list"]], "iocage_lib.ioc_image": [[9, 2, 1, "", "IOCImage"]], "iocage_lib.ioc_image.IOCImage": [[9, 3, 1, "", "export_jail"], [9, 3, 1, "", "import_jail"]], "iocage_lib.ioc_json": [[9, 2, 1, "", "IOCConfiguration"], [9, 2, 1, "", "IOCCpuset"], [9, 2, 1, "", "IOCJson"], [9, 2, 1, "", "IOCRCTL"], [9, 2, 1, "", "JailRuntimeConfiguration"]], "iocage_lib.ioc_json.IOCConfiguration": [[9, 3, 1, "", "backup_iocage_jail_conf"], [9, 3, 1, "", "check_config"], [9, 3, 1, "", "check_default_config"], [9, 3, 1, "", "check_jail_config"], [9, 3, 1, "", "fix_properties"], [9, 3, 1, "", "get_mac_prefix"], [9, 3, 1, "", "get_pool_and_iocroot"], [9, 3, 1, "", "get_version"], [9, 3, 1, "", "json_write"], [9, 3, 1, "", "retrieve_default_props"], [9, 3, 1, "", "validate_mac_prefix"]], "iocage_lib.ioc_json.IOCCpuset": [[9, 3, 1, "", "retrieve_cpu_sets"], [9, 3, 1, "", "set_cpuset"], [9, 3, 1, "", "validate_cpuset_prop"]], "iocage_lib.ioc_json.IOCJson": [[9, 5, 1, "", "default_only_props"], [9, 3, 1, "", "get_full_config"], [9, 3, 1, "", "json_check_prop"], [9, 3, 1, "", "json_convert_from_ucl"], [9, 3, 1, "", "json_convert_from_zfs"], [9, 3, 1, "", "json_get_value"], [9, 3, 1, "", "json_load"], [9, 3, 1, "", "json_migrate_uuid_to_tag"], [9, 3, 1, "", "json_plugin_get_value"], [9, 3, 1, "", "json_plugin_load"], [9, 3, 1, "", "json_plugin_set_value"], [9, 3, 1, "", "json_set_value"], [9, 5, 1, "", "truthy_props"]], "iocage_lib.ioc_json.IOCRCTL": [[9, 3, 1, "", "rctl_rules_exist"], [9, 3, 1, "", "remove_rctl_rules"], [9, 3, 1, "", "set_rctl_rules"], [9, 5, 1, "", "types"], [9, 3, 1, "", "validate_rctl_props"], [9, 3, 1, "", "validate_rctl_tunable"]], "iocage_lib.ioc_json.JailRuntimeConfiguration": [[9, 3, 1, "", "normalize_data"], [9, 6, 1, "", "path"], [9, 3, 1, "", "remove"], [9, 3, 1, "", "set"], [9, 3, 1, "", "sync_changes"]], "iocage_lib.ioc_list": [[9, 2, 1, "", "IOCList"]], "iocage_lib.ioc_list.IOCList": [[9, 3, 1, "", "list_all"], [9, 3, 1, "", "list_all_quick"], [9, 3, 1, "", "list_bases"], [9, 3, 1, "", "list_datasets"], [9, 3, 1, "", "list_get_jid"]], "iocage_lib.ioc_plugin": [[9, 2, 1, "", "IOCPlugin"]], "iocage_lib.ioc_plugin.IOCPlugin": [[9, 5, 1, "", "DEFAULT_PROPS"], [9, 5, 1, "", "PLUGIN_VERSION"], [9, 3, 1, "", "expand_abi_with_specified_release"], [9, 3, 1, "", "fetch_plugin"], [9, 3, 1, "", "fetch_plugin_index"], [9, 3, 1, "", "fetch_plugin_packagesites"], [9, 3, 1, "", "fetch_plugin_versions"], [9, 3, 1, "", "fetch_plugin_versions_from_plugin_index"], [9, 3, 1, "", "pull_clone_git_repo"], [9, 3, 1, "", "retrieve_plugin_index_data"], [9, 3, 1, "", "retrieve_plugin_json"], [9, 3, 1, "", "start_rc"], [9, 3, 1, "", "stop_rc"], [9, 3, 1, "", "update"], [9, 3, 1, "", "upgrade"]], "iocage_lib.ioc_start": [[9, 2, 1, "", "IOCStart"]], "iocage_lib.ioc_start.IOCStart": [[9, 3, 1, "", "check_aliases"], [9, 3, 1, "", "find_bridge_mtu"], [9, 3, 1, "", "get_bridge_members"], [9, 3, 1, "", "get_default_gateway"], [9, 3, 1, "", "get_default_interface"], [9, 3, 1, "", "start_copy_localtime"], [9, 3, 1, "", "start_generate_resolv"], [9, 3, 1, "", "start_network"], [9, 3, 1, "", "start_network_interface_vnet"], [9, 3, 1, "", "start_network_vnet_addr"], [9, 3, 1, "", "start_network_vnet_iface"]], "iocage_lib.ioc_stop": [[9, 2, 1, "", "IOCStop"]], "iocage_lib.ioc_upgrade": [[9, 2, 1, "", "IOCUpgrade"]], "iocage_lib.ioc_upgrade.IOCUpgrade": [[9, 3, 1, "", "upgrade_basejail"], [9, 3, 1, "", "upgrade_jail"]], "iocage_lib.iocage": [[9, 2, 1, "", "IOCage"], [9, 2, 1, "", "PoolAndDataset"]], "iocage_lib.iocage.IOCage": [[9, 3, 1, "", "activate"], [9, 3, 1, "", "chroot"], [9, 3, 1, "", "clean"], [9, 3, 1, "", "create"], [9, 3, 1, "", "deactivate"], [9, 3, 1, "", "debug"], [9, 3, 1, "", "destroy_jail"], [9, 3, 1, "", "destroy_release"], [9, 3, 1, "", "df"], [9, 3, 1, "", "exec"], [9, 3, 1, "", "exec_all"], [9, 3, 1, "", "export"], [9, 3, 1, "", "fetch"], [9, 3, 1, "", "fstab"], [9, 3, 1, "", "get"], [9, 3, 1, "", "import_"], [9, 3, 1, "", "list"], [9, 3, 1, "", "rename"], [9, 3, 1, "", "reset_cache"], [9, 3, 1, "", "restart"], [9, 3, 1, "", "rollback"], [9, 3, 1, "", "set"], [9, 3, 1, "", "snap_list"], [9, 3, 1, "", "snap_remove"], [9, 3, 1, "", "snapshot"], [9, 3, 1, "", "start"], [9, 3, 1, "", "stop"], [9, 3, 1, "", "update"], [9, 3, 1, "", "update_all"], [9, 3, 1, "", "upgrade"], [9, 3, 1, "", "upgrade_all"]], "iocage_lib.iocage.PoolAndDataset": [[9, 3, 1, "", "get_iocroot"], [9, 3, 1, "", "get_pool"]]}, "objtypes": {"0": "py:module", "1": "py:function", "2": "py:class", "3": "py:method", "4": "py:exception", "5": "py:attribute", "6": "py:property"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "function", "Python function"], "2": ["py", "class", "Python class"], "3": ["py", "method", "Python method"], "4": ["py", "exception", "Python exception"], "5": ["py", "attribute", "Python attribute"], "6": ["py", "property", "Python property"]}, "titleterms": {"advanc": 0, "usag": [0, 1], "clone": [0, 8, 10], "creat": [0, 1, 3, 7, 8], "promot": 0, "updat": [0, 7, 8], "jail": [0, 1, 3, 6, 7, 10, 13], "upgrad": [0, 7, 8], "auto": 0, "boot": 0, "prioriti": 0, "depend": 0, "properti": [0, 1], "snapshot": [0, 8], "manag": [0, 6], "resourc": 0, "limit": [0, 11], "legaci": 0, "onli": 0, "core": 0, "thread": 0, "list": [0, 1, 8], "appli": 0, "dram": 0, "us": [0, 7, 13, 16], "turn": 0, "check": 0, "cpu": 0, "automat": 0, "packag": [0, 7, 8, 9, 17], "instal": [0, 7], "basic": 1, "set": [1, 8], "environ": 1, "variabl": 1, "iocag": [1, 6, 7, 9, 12], "activ": [1, 8], "fetch": [1, 8], "releas": [1, 7], "start": [1, 7, 8], "stop": [1, 8], "restart": [1, 8], "configur": [1, 13], "get": [1, 8], "all": 1, "destroi": [1, 8], "renam": [1, 8], "best": 2, "practic": 2, "debian": 3, "buster": 3, "nativ": 3, "linux": 3, "faq": 4, "fastentrypoint": 5, "modul": [5, 8, 9, 15, 17], "A": 6, "freebsd": 6, "document": 6, "indic": 6, "tabl": 6, "binari": 7, "github": 7, "pkg": [7, 8], "8": 7, "build": 7, "port": 7, "from": 7, "iocage_legaci": 7, "migrat": [7, 8], "ezjail": 7, "target": 7, "copi": 7, "old": 7, "data": 7, "popul": 7, "config": 7, "json": 7, "ip": [7, 13], "address": 7, "new": 7, "option": 7, "fstab": [7, 8], "iocage_cli": 8, "submodul": [8, 9, 17], "chroot": 8, "clean": 8, "consol": 8, "debug": 8, "df": 8, "exec": 8, "export": 8, "import": 8, "rollback": 8, "snaplist": 8, "snapremov": 8, "content": [8, 9, 17], "iocage_lib": 9, "ioc_check": 9, "ioc_clean": 9, "ioc_common": 9, "paramet": 9, "ioc_creat": 9, "ioc_debug": 9, "ioc_destroi": 9, "ioc_except": 9, "ioc_exec": 9, "ioc_fetch": 9, "ioc_fstab": 9, "ioc_imag": 9, "ioc_json": 9, "ioc_list": 9, "ioc_plugin": 9, "ioc_start": 9, "ioc_stop": 9, "ioc_upgrad": 9, "type": 10, "default": 10, "basejail": 10, "templat": [10, 16], "empti": 10, "thickjail": 10, "known": 11, "issu": 11, "mount": 11, "path": 11, "vnet": [11, 13], "vimag": [11, 13], "w": 11, "altq": 11, "ipv6": 11, "host": 11, "bind": 11, "failur": 11, "network": 13, "share": 13, "tip": 13, "interfac": 13, "plugin": 14, "setup": 15, "test": 17, "conftest": 17, "data_class": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Advanced Usage": [[0, "advanced-usage"]], "Clones": [[0, "clones"]], "Create a Clone": [[0, "create-a-clone"]], "Promoting a Clone": [[0, "promoting-a-clone"]], "Updating Jails": [[0, "updating-jails"]], "Upgrading Jails": [[0, "upgrading-jails"]], "Auto-boot": [[0, "auto-boot"]], "Boot Priority": [[0, "boot-priority"]], "Depends Property": [[0, "depends-property"]], "Snapshot Management": [[0, "snapshot-management"]], "Resource Limits (Legacy ONLY)": [[0, "resource-limits-legacy-only"]], "Limit Cores or Threads": [[0, "limit-cores-or-threads"]], "List Applied Limits": [[0, "list-applied-limits"]], "Limit DRAM use": [[0, "limit-dram-use"]], "Turn on Resource Limits": [[0, "turn-on-resource-limits"]], "Apply limits": [[0, "apply-limits"]], "Check Limits": [[0, "check-limits"]], "Limit CPU Usage by %": [[0, "limit-cpu-usage-by"]], "Automatic Package Installation": [[0, "automatic-package-installation"]], "Basic Usage": [[1, "basic-usage"]], "Setting Environment Variables": [[1, "setting-environment-variables"]], "iocage Environment Variables": [[1, "id11"]], "Activate iocage": [[1, "activate-iocage"]], "Fetch a Release": [[1, "fetch-a-release"]], "Create a Jail": [[1, "create-a-jail"]], "Listing Jails": [[1, "listing-jails"]], "Start, Stop, or Restart a Jail": [[1, "start-stop-or-restart-a-jail"]], "Start": [[1, "start"]], "Stop": [[1, "stop"]], "Restart": [[1, "restart"]], "Configure a Jail": [[1, "configure-a-jail"]], "Set Jail Property": [[1, "set-jail-property"]], "Get Jail Property": [[1, "get-jail-property"]], "Get all properties:": [[1, "get-all-properties"]], "Destroy a Jail": [[1, "destroy-a-jail"]], "Rename a Jail": [[1, "rename-a-jail"]], "Best Practices": [[2, "best-practices"]], "Create a Debian Buster Jail (native Linux)": [[3, "create-a-debian-buster-jail-native-linux"]], "FAQ": [[4, "faq"]], "fastentrypoints module": [[5, "module-fastentrypoints"]], "iocage - A FreeBSD Jail Manager": [[6, "iocage-a-freebsd-jail-manager"]], "Documentation:": [[6, "documentation"]], "Indices and tables": [[6, "indices-and-tables"]], "Install iocage": [[7, "install-iocage"]], "Using binary packages": [[7, "using-binary-packages"]], "Using github": [[7, "using-github"]], "Using pkg(8)": [[7, "using-pkg-8"]], "Building Ports": [[7, "building-ports"]], "Upgrading from iocage_legacy": [[7, "upgrading-from-iocage-legacy"]], "Migrating from Ezjail to Iocage": [[7, "migrating-from-ezjail-to-iocage"]], "Create Target": [[7, "create-target"]], "Copy Old Data": [[7, "copy-old-data"]], "Populate iocage config.json": [[7, "populate-iocage-config-json"]], "Release": [[7, "release"]], "IP Address": [[7, "ip-address"]], "Start the New Jail": [[7, "start-the-new-jail"]], "(Optional) Update fstab": [[7, "optional-update-fstab"]], "iocage_cli package": [[8, "iocage-cli-package"]], "Submodules": [[8, "submodules"], [9, "submodules"], [17, "submodules"]], "iocage_cli.activate module": [[8, "module-iocage_cli.activate"]], "iocage_cli.chroot module": [[8, "module-iocage_cli.chroot"]], "iocage_cli.clean module": [[8, "module-iocage_cli.clean"]], "iocage_cli.clone module": [[8, "module-iocage_cli.clone"]], "iocage_cli.console module": [[8, "module-iocage_cli.console"]], "iocage_cli.create module": [[8, "module-iocage_cli.create"]], "iocage_cli.debug module": [[8, "module-iocage_cli.debug"]], "iocage_cli.destroy module": [[8, "module-iocage_cli.destroy"]], "iocage_cli.df module": [[8, "module-iocage_cli.df"]], "iocage_cli.exec module": [[8, "module-iocage_cli.exec"]], "iocage_cli.export module": [[8, "module-iocage_cli.export"]], "iocage_cli.fetch module": [[8, "module-iocage_cli.fetch"]], "iocage_cli.fstab module": [[8, "module-iocage_cli.fstab"]], "iocage_cli.get module": [[8, "module-iocage_cli.get"]], "iocage_cli.import module": [[8, "module-iocage_cli.import"]], "iocage_cli.list module": [[8, "module-iocage_cli.list"]], "iocage_cli.migrate module": [[8, "module-iocage_cli.migrate"]], "iocage_cli.pkg module": [[8, "module-iocage_cli.pkg"]], "iocage_cli.rename module": [[8, "module-iocage_cli.rename"]], "iocage_cli.restart module": [[8, "module-iocage_cli.restart"]], "iocage_cli.rollback module": [[8, "module-iocage_cli.rollback"]], "iocage_cli.set module": [[8, "module-iocage_cli.set"]], "iocage_cli.snaplist module": [[8, "module-iocage_cli.snaplist"]], "iocage_cli.snapremove module": [[8, "module-iocage_cli.snapremove"]], "iocage_cli.snapshot module": [[8, "module-iocage_cli.snapshot"]], "iocage_cli.start module": [[8, "module-iocage_cli.start"]], "iocage_cli.stop module": [[8, "module-iocage_cli.stop"]], "iocage_cli.update module": [[8, "module-iocage_cli.update"]], "iocage_cli.upgrade module": [[8, "module-iocage_cli.upgrade"]], "Module contents": [[8, "module-iocage_cli"], [9, "module-iocage_lib"], [17, "module-contents"]], "iocage_lib package": [[9, "iocage-lib-package"]], "iocage_lib.ioc_check module": [[9, "module-iocage_lib.ioc_check"]], "iocage_lib.ioc_clean module": [[9, "module-iocage_lib.ioc_clean"]], "iocage_lib.ioc_common module": [[9, "module-iocage_lib.ioc_common"]], "Parameters": [[9, "parameters"], [9, "id5"]], "iocage_lib.ioc_create module": [[9, "module-iocage_lib.ioc_create"]], "iocage_lib.ioc_debug module": [[9, "module-iocage_lib.ioc_debug"]], "iocage_lib.ioc_destroy module": [[9, "module-iocage_lib.ioc_destroy"]], "iocage_lib.ioc_exceptions module": [[9, "module-iocage_lib.ioc_exceptions"]], "iocage_lib.ioc_exec module": [[9, "module-iocage_lib.ioc_exec"]], "iocage_lib.ioc_fetch module": [[9, "module-iocage_lib.ioc_fetch"]], "iocage_lib.ioc_fstab module": [[9, "module-iocage_lib.ioc_fstab"]], "iocage_lib.ioc_image module": [[9, "module-iocage_lib.ioc_image"]], "iocage_lib.ioc_json module": [[9, "module-iocage_lib.ioc_json"]], "iocage_lib.ioc_list module": [[9, "module-iocage_lib.ioc_list"]], "iocage_lib.ioc_plugin module": [[9, "module-iocage_lib.ioc_plugin"]], "iocage_lib.ioc_start module": [[9, "module-iocage_lib.ioc_start"]], "iocage_lib.ioc_stop module": [[9, "module-iocage_lib.ioc_stop"]], "iocage_lib.ioc_upgrade module": [[9, "module-iocage_lib.ioc_upgrade"]], "iocage_lib.iocage module": [[9, "module-iocage_lib.iocage"]], "Jail Types": [[10, "jail-types"]], "Clone (default)": [[10, "clone-default"]], "Basejail": [[10, "basejail"]], "Template": [[10, "template"]], "Empty": [[10, "empty"]], "Thickjail": [[10, "thickjail"]], "Known Issues": [[11, "known-issues"]], "Mount Path Limit": [[11, "mount-path-limit"]], "VNET/VIMAGE Issues": [[11, "vnet-vimage-issues"]], "VNET/VIMAGE issues w/ ALTQ": [[11, "vnet-vimage-issues-w-altq"]], "IPv6 host bind failures": [[11, "ipv6-host-bind-failures"]], "iocage": [[12, "iocage"]], "Networking": [[13, "networking"]], "Shared IP": [[13, "shared-ip"]], "Using Shared IP": [[13, "using-shared-ip"]], "VIMAGE/VNET": [[13, "vimage-vnet"]], "Tips": [[13, "tips"]], "Configuring Network Interfaces": [[13, "configuring-network-interfaces"]], "Configuring a Shared IP Jail": [[13, "configuring-a-shared-ip-jail"]], "Configuring a VNET Jail": [[13, "configuring-a-vnet-jail"]], "Tips for Configuring VNET": [[13, "tips-for-configuring-vnet"]], "Plugins": [[14, "plugins"]], "Using Templates": [[16, "using-templates"]], "setup module": [[15, "setup-module"]], "tests package": [[17, "tests-package"]], "tests.conftest module": [[17, "tests-conftest-module"]], "tests.data_classes module": [[17, "tests-data-classes-module"]]}, "indexentries": {}}) \ No newline at end of file diff --git a/docs/setup.html b/docs/setup.html new file mode 100644 index 00000000..d4107f35 --- /dev/null +++ b/docs/setup.html @@ -0,0 +1,106 @@ + + + + + + + + + setup module — iocage 1.9 documentation + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

setup module

+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file diff --git a/doc/build/html/templates.html b/docs/templates.html similarity index 100% rename from doc/build/html/templates.html rename to docs/templates.html diff --git a/docs/tests.html b/docs/tests.html new file mode 100644 index 00000000..25df203f --- /dev/null +++ b/docs/tests.html @@ -0,0 +1,118 @@ + + + + + + + + + tests package — iocage 1.9 documentation + + + + + + + + + + + + + +
+
+
+ +
+
+
+ +
+

tests package

+
+

Submodules

+
+
+

tests.conftest module

+
+
+

tests.data_classes module

+
+
+

Module contents

+
+
+ + +
+
+
+
+
+
+ +

Table of Contents

+ + +
+

Search

+
+ + +
+
+ +
+
+
+
+ +
+
+
+
+ modules | + index +
+
+
+
+ +
+ + +
+
+
+
+ + + \ No newline at end of file