Read the Docs build information Build id: 2368944 Project: canonical-pebble Version: latest Commit: 430003866634227b04b1a26207ba729ed13bd388 Date: 2024-07-23T23:00:23.166750Z State: finished Success: True [rtd-command-info] start-time: 2024-07-23T23:00:24.513662Z, end-time: 2024-07-23T23:00:25.983466Z, duration: 1, exit-code: 0 git clone --depth 1 git@github.com:canonical/pebble.git . Cloning into '.'... Warning: Permanently added 'github.com' (ED25519) to the list of known hosts. [rtd-command-info] start-time: 2024-07-23T23:00:26.061917Z, end-time: 2024-07-23T23:00:28.493405Z, duration: 2, exit-code: 0 git fetch origin --force --prune --prune-tags --depth 50 refs/heads/master:refs/remotes/origin/master Warning: Permanently added 'github.com' (ED25519) to the list of known hosts. Warning: Permanently added 'github.com' (ED25519) to the list of known hosts. From github.com:canonical/pebble * [new tag] v1.10.0 -> v1.10.0 * [new tag] v1.11.0 -> v1.11.0 * [new tag] v1.12.0 -> v1.12.0 * [new tag] v1.13.0 -> v1.13.0 * [new tag] v1.14.0 -> v1.14.0 * [new tag] v1.15.0 -> v1.15.0 [rtd-command-info] start-time: 2024-07-23T23:00:28.622505Z, end-time: 2024-07-23T23:00:28.710568Z, duration: 0, exit-code: 0 git checkout --force origin/master Note: switching to 'origin/master'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by switching back to a branch. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -c with the switch command. Example: git switch -c Or undo this operation with: git switch - Turn off this advice by setting config variable advice.detachedHead to false HEAD is now at 4300038 docs: remove howtos and add references (#438) [rtd-command-info] start-time: 2024-07-23T23:00:28.781220Z, end-time: 2024-07-23T23:00:28.841454Z, duration: 0, exit-code: 0 cat docs/.readthedocs.yaml # .readthedocs.yaml # Read the Docs configuration file # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details # Required version: 2 # Set the version of Python and other tools you might need build: os: ubuntu-22.04 tools: python: "3.11" jobs: post_checkout: - cd docs && python3 .sphinx/build_requirements.py apt_packages: - distro-info # Build documentation in the docs/ directory with Sphinx sphinx: builder: dirhtml configuration: docs/conf.py fail_on_warning: true # If using Sphinx, optionally build your docs in additional formats such as PDF formats: - pdf # Optionally declare the Python requirements required to build your docs python: install: - requirements: docs/.sphinx/requirements.txt [rtd-command-info] start-time: 2024-07-23T23:00:28.921353Z, end-time: 2024-07-23T23:00:29.003957Z, duration: 0, exit-code: 0 cd docs && python3 .sphinx/build_requirements.py [rtd-command-info] start-time: 2024-07-23T23:00:30.658502Z, end-time: 2024-07-23T23:00:33.928629Z, duration: 3, exit-code: 0 apt-get update --assume-yes --quiet Get:1 http://security.ubuntu.com/ubuntu jammy-security InRelease [129 kB] Hit:2 http://archive.ubuntu.com/ubuntu jammy InRelease Get:3 http://archive.ubuntu.com/ubuntu jammy-updates InRelease [128 kB] Get:4 http://security.ubuntu.com/ubuntu jammy-security/multiverse amd64 Packages [44.7 kB] Get:5 http://security.ubuntu.com/ubuntu jammy-security/restricted amd64 Packages [2717 kB] Get:6 http://archive.ubuntu.com/ubuntu jammy-backports InRelease [127 kB] Get:7 http://security.ubuntu.com/ubuntu jammy-security/universe amd64 Packages [1128 kB] Get:8 http://security.ubuntu.com/ubuntu jammy-security/main amd64 Packages [2071 kB] Get:9 http://archive.ubuntu.com/ubuntu jammy-updates/universe amd64 Packages [1418 kB] Get:10 http://archive.ubuntu.com/ubuntu jammy-updates/main amd64 Packages [2338 kB] Get:11 http://archive.ubuntu.com/ubuntu jammy-updates/restricted amd64 Packages [2795 kB] Get:12 http://archive.ubuntu.com/ubuntu jammy-updates/multiverse amd64 Packages [51.8 kB] Get:13 http://archive.ubuntu.com/ubuntu jammy-backports/universe amd64 Packages [33.7 kB] Get:14 http://archive.ubuntu.com/ubuntu jammy-backports/main amd64 Packages [81.0 kB] Fetched 13.1 MB in 2s (6067 kB/s) Reading package lists... [rtd-command-info] start-time: 2024-07-23T23:00:33.996400Z, end-time: 2024-07-23T23:00:36.408471Z, duration: 2, exit-code: 0 apt-get install --assume-yes --quiet -- distro-info Reading package lists... Building dependency tree... Reading state information... Suggested packages: shunit2 The following NEW packages will be installed: distro-info 0 upgraded, 1 newly installed, 0 to remove and 148 not upgraded. Need to get 18.7 kB of archives. After this operation, 70.7 kB of additional disk space will be used. Get:1 http://archive.ubuntu.com/ubuntu jammy-updates/main amd64 distro-info amd64 1.1ubuntu0.2 [18.7 kB] debconf: delaying package configuration, since apt-utils is not installed Fetched 18.7 kB in 0s (39.4 kB/s) Selecting previously unselected package distro-info. (Reading database ... (Reading database ... 5% (Reading database ... 10% (Reading database ... 15% (Reading database ... 20% (Reading database ... 25% (Reading database ... 30% (Reading database ... 35% (Reading database ... 40% (Reading database ... 45% (Reading database ... 50% (Reading database ... 55% (Reading database ... 60% (Reading database ... 65% (Reading database ... 70% (Reading database ... 75% (Reading database ... 80% (Reading database ... 85% (Reading database ... 90% (Reading database ... 95% (Reading database ... 100% (Reading database ... 272117 files and directories currently installed.) Preparing to unpack .../distro-info_1.1ubuntu0.2_amd64.deb ... Unpacking distro-info (1.1ubuntu0.2) ... Setting up distro-info (1.1ubuntu0.2) ... [rtd-command-info] start-time: 2024-07-23T23:00:41.629402Z, end-time: 2024-07-23T23:00:41.709651Z, duration: 0, exit-code: 0 asdf global python 3.11.9 [rtd-command-info] start-time: 2024-07-23T23:00:42.123629Z, end-time: 2024-07-23T23:00:43.209990Z, duration: 1, exit-code: 0 python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH created virtual environment CPython3.11.9.final.0-64 in 755ms creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest, clear=False, no_vcs_ignore=False, global=False) seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/docs/.local/share/virtualenv) added seed packages: pip==23.1, setuptools==67.6.1, wheel==0.40.0 activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator [rtd-command-info] start-time: 2024-07-23T23:00:43.277788Z, end-time: 2024-07-23T23:00:56.322436Z, duration: 13, exit-code: 0 python -m pip install --upgrade --no-cache-dir pip setuptools Requirement already satisfied: pip in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (23.1) Collecting pip Downloading pip-24.1.2-py3-none-any.whl (1.8 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 8.3 MB/s eta 0:00:00 Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (67.6.1) Collecting setuptools Downloading setuptools-71.1.0-py3-none-any.whl (2.3 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.3/2.3 MB 20.0 MB/s eta 0:00:00 Installing collected packages: setuptools, pip Attempting uninstall: setuptools Found existing installation: setuptools 67.6.1 Uninstalling setuptools-67.6.1: Successfully uninstalled setuptools-67.6.1 Attempting uninstall: pip Found existing installation: pip 23.1 Uninstalling pip-23.1: Successfully uninstalled pip-23.1 Successfully installed pip-24.1.2 setuptools-71.1.0 [rtd-command-info] start-time: 2024-07-23T23:00:56.416678Z, end-time: 2024-07-23T23:01:06.869143Z, duration: 10, exit-code: 0 python -m pip install --upgrade --no-cache-dir sphinx readthedocs-sphinx-ext Collecting sphinx Downloading sphinx-7.4.7-py3-none-any.whl.metadata (6.1 kB) Collecting readthedocs-sphinx-ext Downloading readthedocs_sphinx_ext-2.2.5-py2.py3-none-any.whl.metadata (1.5 kB) Collecting sphinxcontrib-applehelp (from sphinx) Downloading sphinxcontrib_applehelp-1.0.8-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-devhelp (from sphinx) Downloading sphinxcontrib_devhelp-1.0.6-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-jsmath (from sphinx) Downloading sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl.metadata (1.4 kB) Collecting sphinxcontrib-htmlhelp>=2.0.0 (from sphinx) Downloading sphinxcontrib_htmlhelp-2.0.6-py3-none-any.whl.metadata (2.3 kB) Collecting sphinxcontrib-serializinghtml>=1.1.9 (from sphinx) Downloading sphinxcontrib_serializinghtml-1.1.10-py3-none-any.whl.metadata (2.4 kB) Collecting sphinxcontrib-qthelp (from sphinx) Downloading sphinxcontrib_qthelp-1.0.8-py3-none-any.whl.metadata (2.3 kB) Collecting Jinja2>=3.1 (from sphinx) Downloading jinja2-3.1.4-py3-none-any.whl.metadata (2.6 kB) Collecting Pygments>=2.17 (from sphinx) Downloading pygments-2.18.0-py3-none-any.whl.metadata (2.5 kB) Collecting docutils<0.22,>=0.20 (from sphinx) Downloading docutils-0.21.2-py3-none-any.whl.metadata (2.8 kB) Collecting snowballstemmer>=2.2 (from sphinx) Downloading snowballstemmer-2.2.0-py2.py3-none-any.whl.metadata (6.5 kB) Collecting babel>=2.13 (from sphinx) Downloading Babel-2.15.0-py3-none-any.whl.metadata (1.5 kB) Collecting alabaster~=0.7.14 (from sphinx) Downloading alabaster-0.7.16-py3-none-any.whl.metadata (2.9 kB) Collecting imagesize>=1.3 (from sphinx) Downloading imagesize-1.4.1-py2.py3-none-any.whl.metadata (1.5 kB) Collecting requests>=2.30.0 (from sphinx) Downloading requests-2.32.3-py3-none-any.whl.metadata (4.6 kB) Collecting packaging>=23.0 (from sphinx) Downloading packaging-24.1-py3-none-any.whl.metadata (3.2 kB) Collecting MarkupSafe>=2.0 (from Jinja2>=3.1->sphinx) Downloading MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (3.0 kB) Collecting charset-normalizer<4,>=2 (from requests>=2.30.0->sphinx) Downloading charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (33 kB) Collecting idna<4,>=2.5 (from requests>=2.30.0->sphinx) Downloading idna-3.7-py3-none-any.whl.metadata (9.9 kB) Collecting urllib3<3,>=1.21.1 (from requests>=2.30.0->sphinx) Downloading urllib3-2.2.2-py3-none-any.whl.metadata (6.4 kB) Collecting certifi>=2017.4.17 (from requests>=2.30.0->sphinx) Downloading certifi-2024.7.4-py3-none-any.whl.metadata (2.2 kB) Downloading sphinx-7.4.7-py3-none-any.whl (3.4 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.4/3.4 MB 56.5 MB/s eta 0:00:00 Downloading readthedocs_sphinx_ext-2.2.5-py2.py3-none-any.whl (11 kB) Downloading alabaster-0.7.16-py3-none-any.whl (13 kB) Downloading Babel-2.15.0-py3-none-any.whl (9.6 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 9.6/9.6 MB 135.9 MB/s eta 0:00:00 Downloading docutils-0.21.2-py3-none-any.whl (587 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 587.4/587.4 kB 177.4 MB/s eta 0:00:00 Downloading imagesize-1.4.1-py2.py3-none-any.whl (8.8 kB) Downloading jinja2-3.1.4-py3-none-any.whl (133 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 133.3/133.3 kB 185.2 MB/s eta 0:00:00 Downloading packaging-24.1-py3-none-any.whl (53 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 54.0/54.0 kB 144.1 MB/s eta 0:00:00 Downloading pygments-2.18.0-py3-none-any.whl (1.2 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 177.8 MB/s eta 0:00:00 Downloading requests-2.32.3-py3-none-any.whl (64 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 64.9/64.9 kB 142.4 MB/s eta 0:00:00 Downloading snowballstemmer-2.2.0-py2.py3-none-any.whl (93 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 93.0/93.0 kB 149.9 MB/s eta 0:00:00 Downloading sphinxcontrib_htmlhelp-2.0.6-py3-none-any.whl (99 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 99.2/99.2 kB 150.8 MB/s eta 0:00:00 Downloading sphinxcontrib_serializinghtml-1.1.10-py3-none-any.whl (92 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 92.7/92.7 kB 150.9 MB/s eta 0:00:00 Downloading sphinxcontrib_applehelp-1.0.8-py3-none-any.whl (120 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 120.0/120.0 kB 157.4 MB/s eta 0:00:00 Downloading sphinxcontrib_devhelp-1.0.6-py3-none-any.whl (83 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 83.5/83.5 kB 154.6 MB/s eta 0:00:00 Downloading sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl (5.1 kB) Downloading sphinxcontrib_qthelp-1.0.8-py3-none-any.whl (89 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 89.5/89.5 kB 152.0 MB/s eta 0:00:00 Downloading certifi-2024.7.4-py3-none-any.whl (162 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 163.0/163.0 kB 181.8 MB/s eta 0:00:00 Downloading charset_normalizer-3.3.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (140 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 140.3/140.3 kB 156.9 MB/s eta 0:00:00 Downloading idna-3.7-py3-none-any.whl (66 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 66.8/66.8 kB 143.8 MB/s eta 0:00:00 Downloading MarkupSafe-2.1.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (28 kB) Downloading urllib3-2.2.2-py3-none-any.whl (121 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 121.4/121.4 kB 167.4 MB/s eta 0:00:00 Installing collected packages: snowballstemmer, urllib3, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, Pygments, packaging, MarkupSafe, imagesize, idna, docutils, charset-normalizer, certifi, babel, alabaster, requests, Jinja2, sphinx, readthedocs-sphinx-ext Successfully installed Jinja2-3.1.4 MarkupSafe-2.1.5 Pygments-2.18.0 alabaster-0.7.16 babel-2.15.0 certifi-2024.7.4 charset-normalizer-3.3.2 docutils-0.21.2 idna-3.7 imagesize-1.4.1 packaging-24.1 readthedocs-sphinx-ext-2.2.5 requests-2.32.3 snowballstemmer-2.2.0 sphinx-7.4.7 sphinxcontrib-applehelp-1.0.8 sphinxcontrib-devhelp-1.0.6 sphinxcontrib-htmlhelp-2.0.6 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-qthelp-1.0.8 sphinxcontrib-serializinghtml-1.1.10 urllib3-2.2.2 [rtd-command-info] start-time: 2024-07-23T23:01:06.995307Z, end-time: 2024-07-23T23:01:15.952937Z, duration: 8, exit-code: 0 python -m pip install --exists-action=w --no-cache-dir -r docs/.sphinx/requirements.txt Collecting GitPython (from -r docs/.sphinx/requirements.txt (line 7)) Downloading GitPython-3.1.43-py3-none-any.whl.metadata (13 kB) Collecting canonical-sphinx-extensions (from -r docs/.sphinx/requirements.txt (line 8)) Downloading canonical_sphinx_extensions-0.0.23-py3-none-any.whl.metadata (15 kB) Collecting furo (from -r docs/.sphinx/requirements.txt (line 9)) Downloading furo-2024.7.18-py3-none-any.whl.metadata (5.9 kB) Collecting linkify-it-py (from -r docs/.sphinx/requirements.txt (line 10)) Downloading linkify_it_py-2.0.3-py3-none-any.whl.metadata (8.5 kB) Collecting myst-parser (from -r docs/.sphinx/requirements.txt (line 11)) Downloading myst_parser-3.0.1-py3-none-any.whl.metadata (5.5 kB) Collecting pyspelling (from -r docs/.sphinx/requirements.txt (line 12)) Downloading pyspelling-2.10-py3-none-any.whl.metadata (3.8 kB) Requirement already satisfied: sphinx in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from -r docs/.sphinx/requirements.txt (line 13)) (7.4.7) Collecting sphinx-autobuild (from -r docs/.sphinx/requirements.txt (line 14)) Downloading sphinx_autobuild-2024.4.16-py3-none-any.whl.metadata (7.7 kB) Collecting sphinx-copybutton (from -r docs/.sphinx/requirements.txt (line 15)) Downloading sphinx_copybutton-0.5.2-py3-none-any.whl.metadata (3.2 kB) Collecting sphinx-design (from -r docs/.sphinx/requirements.txt (line 16)) Downloading sphinx_design-0.6.0-py3-none-any.whl.metadata (5.2 kB) Collecting sphinx-notfound-page (from -r docs/.sphinx/requirements.txt (line 17)) Downloading sphinx_notfound_page-1.0.2-py3-none-any.whl.metadata (2.9 kB) Collecting sphinx-tabs (from -r docs/.sphinx/requirements.txt (line 18)) Downloading sphinx_tabs-3.4.5-py3-none-any.whl.metadata (6.3 kB) Collecting sphinxcontrib-jquery (from -r docs/.sphinx/requirements.txt (line 19)) Downloading sphinxcontrib_jquery-4.1-py2.py3-none-any.whl.metadata (2.6 kB) Collecting sphinxext-opengraph (from -r docs/.sphinx/requirements.txt (line 20)) Downloading sphinxext_opengraph-0.9.1-py3-none-any.whl.metadata (6.5 kB) Collecting watchfiles (from -r docs/.sphinx/requirements.txt (line 21)) Downloading watchfiles-0.22.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.9 kB) Collecting gitdb<5,>=4.0.1 (from GitPython->-r docs/.sphinx/requirements.txt (line 7)) Downloading gitdb-4.0.11-py3-none-any.whl.metadata (1.2 kB) Requirement already satisfied: requests in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) (2.32.3) Collecting beautifulsoup4 (from canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) Downloading beautifulsoup4-4.12.3-py3-none-any.whl.metadata (3.8 kB) Requirement already satisfied: docutils in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) (0.21.2) Collecting sphinx-basic-ng>=1.0.0.beta2 (from furo->-r docs/.sphinx/requirements.txt (line 9)) Downloading sphinx_basic_ng-1.0.0b2-py3-none-any.whl.metadata (1.5 kB) Requirement already satisfied: pygments>=2.7 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from furo->-r docs/.sphinx/requirements.txt (line 9)) (2.18.0) Collecting uc-micro-py (from linkify-it-py->-r docs/.sphinx/requirements.txt (line 10)) Downloading uc_micro_py-1.0.3-py3-none-any.whl.metadata (2.0 kB) Requirement already satisfied: jinja2 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from myst-parser->-r docs/.sphinx/requirements.txt (line 11)) (3.1.4) Collecting markdown-it-py~=3.0 (from myst-parser->-r docs/.sphinx/requirements.txt (line 11)) Downloading markdown_it_py-3.0.0-py3-none-any.whl.metadata (6.9 kB) Collecting mdit-py-plugins~=0.4 (from myst-parser->-r docs/.sphinx/requirements.txt (line 11)) Downloading mdit_py_plugins-0.4.1-py3-none-any.whl.metadata (2.8 kB) Collecting pyyaml (from myst-parser->-r docs/.sphinx/requirements.txt (line 11)) Downloading PyYAML-6.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (2.1 kB) Collecting html5lib (from pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading html5lib-1.1-py2.py3-none-any.whl.metadata (16 kB) Collecting lxml (from pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading lxml-5.2.2-cp311-cp311-manylinux_2_28_x86_64.whl.metadata (3.4 kB) Collecting markdown (from pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading Markdown-3.6-py3-none-any.whl.metadata (7.0 kB) Collecting soupsieve>=1.8 (from pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading soupsieve-2.5-py3-none-any.whl.metadata (4.7 kB) Collecting wcmatch>=8.5 (from pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading wcmatch-8.5.2-py3-none-any.whl.metadata (4.8 kB) Requirement already satisfied: sphinxcontrib-applehelp in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.0.8) Requirement already satisfied: sphinxcontrib-devhelp in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.0.6) Requirement already satisfied: sphinxcontrib-jsmath in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.0.1) Requirement already satisfied: sphinxcontrib-htmlhelp>=2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (2.0.6) Requirement already satisfied: sphinxcontrib-serializinghtml>=1.1.9 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.1.10) Requirement already satisfied: sphinxcontrib-qthelp in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.0.8) Requirement already satisfied: snowballstemmer>=2.2 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (2.2.0) Requirement already satisfied: babel>=2.13 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (2.15.0) Requirement already satisfied: alabaster~=0.7.14 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (0.7.16) Requirement already satisfied: imagesize>=1.3 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (1.4.1) Requirement already satisfied: packaging>=23.0 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from sphinx->-r docs/.sphinx/requirements.txt (line 13)) (24.1) Collecting colorama (from sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading colorama-0.4.6-py2.py3-none-any.whl.metadata (17 kB) Collecting starlette>=0.35 (from sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading starlette-0.38.1-py3-none-any.whl.metadata (5.9 kB) Collecting uvicorn>=0.25 (from sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading uvicorn-0.30.3-py3-none-any.whl.metadata (6.5 kB) Collecting websockets>=11 (from sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading websockets-12.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (6.6 kB) Collecting anyio>=3.0.0 (from watchfiles->-r docs/.sphinx/requirements.txt (line 21)) Downloading anyio-4.4.0-py3-none-any.whl.metadata (4.6 kB) Requirement already satisfied: idna>=2.8 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from anyio>=3.0.0->watchfiles->-r docs/.sphinx/requirements.txt (line 21)) (3.7) Collecting sniffio>=1.1 (from anyio>=3.0.0->watchfiles->-r docs/.sphinx/requirements.txt (line 21)) Downloading sniffio-1.3.1-py3-none-any.whl.metadata (3.9 kB) Collecting smmap<6,>=3.0.1 (from gitdb<5,>=4.0.1->GitPython->-r docs/.sphinx/requirements.txt (line 7)) Downloading smmap-5.0.1-py3-none-any.whl.metadata (4.3 kB) Requirement already satisfied: MarkupSafe>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from jinja2->myst-parser->-r docs/.sphinx/requirements.txt (line 11)) (2.1.5) Collecting mdurl~=0.1 (from markdown-it-py~=3.0->myst-parser->-r docs/.sphinx/requirements.txt (line 11)) Downloading mdurl-0.1.2-py3-none-any.whl.metadata (1.6 kB) Requirement already satisfied: charset-normalizer<4,>=2 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from requests->canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) (3.3.2) Requirement already satisfied: urllib3<3,>=1.21.1 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from requests->canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) (2.2.2) Requirement already satisfied: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/envs/latest/lib/python3.11/site-packages (from requests->canonical-sphinx-extensions->-r docs/.sphinx/requirements.txt (line 8)) (2024.7.4) Collecting click>=7.0 (from uvicorn>=0.25->sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading click-8.1.7-py3-none-any.whl.metadata (3.0 kB) Collecting h11>=0.8 (from uvicorn>=0.25->sphinx-autobuild->-r docs/.sphinx/requirements.txt (line 14)) Downloading h11-0.14.0-py3-none-any.whl.metadata (8.2 kB) Collecting bracex>=2.1.1 (from wcmatch>=8.5->pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading bracex-2.4-py3-none-any.whl.metadata (3.6 kB) Collecting six>=1.9 (from html5lib->pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading six-1.16.0-py2.py3-none-any.whl.metadata (1.8 kB) Collecting webencodings (from html5lib->pyspelling->-r docs/.sphinx/requirements.txt (line 12)) Downloading webencodings-0.5.1-py2.py3-none-any.whl.metadata (2.1 kB) Downloading GitPython-3.1.43-py3-none-any.whl (207 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 207.3/207.3 kB 9.9 MB/s eta 0:00:00 Downloading canonical_sphinx_extensions-0.0.23-py3-none-any.whl (38 kB) Downloading furo-2024.7.18-py3-none-any.whl (340 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 340.8/340.8 kB 49.1 MB/s eta 0:00:00 Downloading linkify_it_py-2.0.3-py3-none-any.whl (19 kB) Downloading myst_parser-3.0.1-py3-none-any.whl (83 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 83.2/83.2 kB 143.5 MB/s eta 0:00:00 Downloading pyspelling-2.10-py3-none-any.whl (45 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 45.0/45.0 kB 102.4 MB/s eta 0:00:00 Downloading sphinx_autobuild-2024.4.16-py3-none-any.whl (11 kB) Downloading sphinx_copybutton-0.5.2-py3-none-any.whl (13 kB) Downloading sphinx_design-0.6.0-py3-none-any.whl (2.2 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.2/2.2 MB 120.8 MB/s eta 0:00:00 Downloading sphinx_notfound_page-1.0.2-py3-none-any.whl (8.1 kB) Downloading sphinx_tabs-3.4.5-py3-none-any.whl (9.9 kB) Downloading sphinxcontrib_jquery-4.1-py2.py3-none-any.whl (121 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 121.1/121.1 kB 131.1 MB/s eta 0:00:00 Downloading sphinxext_opengraph-0.9.1-py3-none-any.whl (1.0 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.0/1.0 MB 178.3 MB/s eta 0:00:00 Downloading watchfiles-0.22.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.2 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 179.2 MB/s eta 0:00:00 Downloading anyio-4.4.0-py3-none-any.whl (86 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 86.8/86.8 kB 163.3 MB/s eta 0:00:00 Downloading gitdb-4.0.11-py3-none-any.whl (62 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.7/62.7 kB 157.7 MB/s eta 0:00:00 Downloading markdown_it_py-3.0.0-py3-none-any.whl (87 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 87.5/87.5 kB 161.7 MB/s eta 0:00:00 Downloading mdit_py_plugins-0.4.1-py3-none-any.whl (54 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 54.8/54.8 kB 161.8 MB/s eta 0:00:00 Downloading soupsieve-2.5-py3-none-any.whl (36 kB) Downloading sphinx_basic_ng-1.0.0b2-py3-none-any.whl (22 kB) Downloading starlette-0.38.1-py3-none-any.whl (72 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 72.0/72.0 kB 154.9 MB/s eta 0:00:00 Downloading uvicorn-0.30.3-py3-none-any.whl (62 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.8/62.8 kB 156.9 MB/s eta 0:00:00 Downloading wcmatch-8.5.2-py3-none-any.whl (39 kB) Downloading websockets-12.0-cp311-cp311-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (130 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 130.9/130.9 kB 157.9 MB/s eta 0:00:00 Downloading beautifulsoup4-4.12.3-py3-none-any.whl (147 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 147.9/147.9 kB 160.1 MB/s eta 0:00:00 Downloading colorama-0.4.6-py2.py3-none-any.whl (25 kB) Downloading html5lib-1.1-py2.py3-none-any.whl (112 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 112.2/112.2 kB 177.4 MB/s eta 0:00:00 Downloading lxml-5.2.2-cp311-cp311-manylinux_2_28_x86_64.whl (5.0 MB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 5.0/5.0 MB 150.8 MB/s eta 0:00:00 Downloading Markdown-3.6-py3-none-any.whl (105 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 105.4/105.4 kB 175.2 MB/s eta 0:00:00 Downloading PyYAML-6.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (757 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 757.7/757.7 kB 192.5 MB/s eta 0:00:00 Downloading uc_micro_py-1.0.3-py3-none-any.whl (6.2 kB) Downloading bracex-2.4-py3-none-any.whl (11 kB) Downloading click-8.1.7-py3-none-any.whl (97 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 97.9/97.9 kB 141.2 MB/s eta 0:00:00 Downloading h11-0.14.0-py3-none-any.whl (58 kB) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 58.3/58.3 kB 129.2 MB/s eta 0:00:00 Downloading mdurl-0.1.2-py3-none-any.whl (10.0 kB) Downloading six-1.16.0-py2.py3-none-any.whl (11 kB) Downloading smmap-5.0.1-py3-none-any.whl (24 kB) Downloading sniffio-1.3.1-py3-none-any.whl (10 kB) Downloading webencodings-0.5.1-py2.py3-none-any.whl (11 kB) Installing collected packages: webencodings, websockets, uc-micro-py, soupsieve, sniffio, smmap, six, pyyaml, mdurl, markdown, lxml, h11, colorama, click, bracex, wcmatch, uvicorn, markdown-it-py, linkify-it-py, html5lib, gitdb, beautifulsoup4, anyio, watchfiles, starlette, sphinxext-opengraph, sphinxcontrib-jquery, sphinx-tabs, sphinx-notfound-page, sphinx-design, sphinx-copybutton, sphinx-basic-ng, pyspelling, mdit-py-plugins, GitPython, sphinx-autobuild, myst-parser, furo, canonical-sphinx-extensions Successfully installed GitPython-3.1.43 anyio-4.4.0 beautifulsoup4-4.12.3 bracex-2.4 canonical-sphinx-extensions-0.0.23 click-8.1.7 colorama-0.4.6 furo-2024.7.18 gitdb-4.0.11 h11-0.14.0 html5lib-1.1 linkify-it-py-2.0.3 lxml-5.2.2 markdown-3.6 markdown-it-py-3.0.0 mdit-py-plugins-0.4.1 mdurl-0.1.2 myst-parser-3.0.1 pyspelling-2.10 pyyaml-6.0.1 six-1.16.0 smmap-5.0.1 sniffio-1.3.1 soupsieve-2.5 sphinx-autobuild-2024.4.16 sphinx-basic-ng-1.0.0b2 sphinx-copybutton-0.5.2 sphinx-design-0.6.0 sphinx-notfound-page-1.0.2 sphinx-tabs-3.4.5 sphinxcontrib-jquery-4.1 sphinxext-opengraph-0.9.1 starlette-0.38.1 uc-micro-py-1.0.3 uvicorn-0.30.3 watchfiles-0.22.0 wcmatch-8.5.2 webencodings-0.5.1 websockets-12.0 [rtd-command-info] start-time: 2024-07-23T23:01:16.570041Z, end-time: 2024-07-23T23:01:16.652531Z, duration: 0, exit-code: 0 cat docs/conf.py import sys import os import requests from urllib.parse import urlparse from git import Repo import subprocess import time sys.path.append('./') from custom_conf import * sys.path.append('.sphinx/') from build_requirements import * # Configuration file for the Sphinx documentation builder. # You should not do any modifications to this file. Put your custom # configuration into the custom_conf.py file. # If you need to change this file, contribute the changes upstream. # # For the full list of built-in configuration values, see the documentation: # https://www.sphinx-doc.org/en/master/usage/configuration.html ############################################################ ### Extensions ############################################################ extensions = [ 'sphinx_design', 'sphinx_copybutton', 'sphinxcontrib.jquery', ] # Only add redirects extension if any redirects are specified. if AreRedirectsDefined(): extensions.append('sphinx_reredirects') # Only add myst extensions if any configuration is present. if IsMyStParserUsed(): extensions.append('myst_parser') # Additional MyST syntax myst_enable_extensions = [ 'substitution', 'deflist', 'linkify' ] myst_enable_extensions.extend(custom_myst_extensions) # Only add Open Graph extension if any configuration is present. if IsOpenGraphConfigured(): extensions.append('sphinxext.opengraph') extensions.extend(custom_extensions) extensions = DeduplicateExtensions(extensions) ### Configuration for extensions # Used for related links if not 'discourse_prefix' in html_context and 'discourse' in html_context: html_context['discourse_prefix'] = html_context['discourse'] + '/t/' # The URL prefix for the notfound extension depends on whether the documentation uses versions. # For documentation on documentation.ubuntu.com, we also must add the slug. url_version = '' url_lang = '' # Determine if the URL uses versions and language if 'READTHEDOCS_CANONICAL_URL' in os.environ and os.environ['READTHEDOCS_CANONICAL_URL']: url_parts = os.environ['READTHEDOCS_CANONICAL_URL'].split('/') if len(url_parts) >= 2 and 'READTHEDOCS_VERSION' in os.environ and os.environ['READTHEDOCS_VERSION'] == url_parts[-2]: url_version = url_parts[-2] + '/' if len(url_parts) >= 3 and 'READTHEDOCS_LANGUAGE' in os.environ and os.environ['READTHEDOCS_LANGUAGE'] == url_parts[-3]: url_lang = url_parts[-3] + '/' # Set notfound_urls_prefix to the slug (if defined) and the version/language affix if slug: notfound_urls_prefix = '/' + slug + '/' + url_lang + url_version elif len(url_lang + url_version) > 0: notfound_urls_prefix = '/' + url_lang + url_version else: notfound_urls_prefix = '' notfound_context = { 'title': 'Page not found', 'body': '

Sorry, but the documentation page that you are looking for was not found.

\n\n

Documentation changes over time, and pages are moved around. We try to redirect you to the updated content where possible, but unfortunately, that didn\'t work this time (maybe because the content you were looking for does not exist in this version of the documentation).

\n

You can try to use the navigation to locate the content you\'re looking for, or search for a similar page.

\n', } # Default image for OGP (to prevent font errors, see # https://github.com/canonical/sphinx-docs-starter-pack/pull/54 ) if not 'ogp_image' in locals(): ogp_image = 'https://assets.ubuntu.com/v1/253da317-image-document-ubuntudocs.svg' ############################################################ ### General configuration ############################################################ exclude_patterns = [ '_build', 'Thumbs.db', '.DS_Store', '.sphinx', ] exclude_patterns.extend(custom_excludes) rst_epilog = ''' .. include:: /reuse/links.txt ''' if 'custom_rst_epilog' in locals(): rst_epilog = custom_rst_epilog if 'custom_manpages_url' in locals(): manpages_url = custom_manpages_url else: manpages_distribution = subprocess.check_output("distro-info --stable", text=True, shell=True).strip() manpages_url = ("https://manpages.ubuntu.com/manpages/" f"{manpages_distribution}/en/" "man{section}/{page}.{section}.html") source_suffix = { '.rst': 'restructuredtext', '.md': 'markdown', } if not 'conf_py_path' in html_context and 'github_folder' in html_context: html_context['conf_py_path'] = html_context['github_folder'] # For ignoring specific links linkcheck_anchors_ignore_for_url = [ r'https://github\.com/.*' ] linkcheck_anchors_ignore_for_url.extend(custom_linkcheck_anchors_ignore_for_url) # Tags cannot be added directly in custom_conf.py, so add them here for tag in custom_tags: tags.add(tag) # html_context['get_contribs'] is a function and cannot be # cached (see https://github.com/sphinx-doc/sphinx/issues/12300) suppress_warnings = ["config.cache"] ############################################################ ### Styling ############################################################ # Find the current builder builder = 'dirhtml' if '-b' in sys.argv: builder = sys.argv[sys.argv.index('-b')+1] # Setting templates_path for epub makes the build fail if builder == 'dirhtml' or builder == 'html': templates_path = ['.sphinx/_templates'] notfound_template = '404.html' # Theme configuration html_theme = 'furo' html_last_updated_fmt = '' html_permalinks_icon = '¶' if html_title == '': html_theme_options = { 'sidebar_hide_name': True } ############################################################ ### Additional files ############################################################ html_static_path = ['.sphinx/_static'] html_css_files = [ 'custom.css', 'header.css', 'github_issue_links.css', 'furo_colors.css', 'footer.css' ] html_css_files.extend(custom_html_css_files) html_js_files = ['header-nav.js', 'footer.js'] if 'github_issues' in html_context and html_context['github_issues'] and not disable_feedback_button: html_js_files.append('github_issue_links.js') html_js_files.extend(custom_html_js_files) ############################################################# # Display the contributors def get_contributors_for_file(github_url, github_folder, pagename, page_source_suffix, display_contributors_since=None): filename = f"{pagename}{page_source_suffix}" paths=html_context['github_folder'][1:] + filename repo = Repo("../") since = display_contributors_since if display_contributors_since and display_contributors_since.strip() else None commits = repo.iter_commits(paths=paths, since=since) contributors_dict = {} for commit in commits: contributor = commit.author.name if contributor not in contributors_dict or commit.committed_date > contributors_dict[contributor]['date']: contributors_dict[contributor] = { 'date': commit.committed_date, 'sha': commit.hexsha } # The github_page contains the link to the contributor's latest commit. contributors_list = [{'name': name, 'github_page': f"{github_url}/commit/{data['sha']}"} for name, data in contributors_dict.items()] sorted_contributors_list = sorted(contributors_list, key=lambda x: x['name']) return sorted_contributors_list html_context['get_contribs'] = get_contributors_for_file ############################################################# ########################################################################### # auto-created readthedocs.org specific configuration # ########################################################################### # # The following code was added during an automated build on readthedocs.org # It is auto created and injected for every build. The result is based on the # conf.py.tmpl file found in the readthedocs.org codebase: # https://github.com/rtfd/readthedocs.org/blob/main/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl # # Note: this file shouldn't rely on extra dependencies. import importlib import sys import os.path # Borrowed from six. PY3 = sys.version_info[0] == 3 string_types = str if PY3 else basestring from sphinx import version_info # Get suffix for proper linking to GitHub # This is deprecated in Sphinx 1.3+, # as each page can have its own suffix if globals().get('source_suffix', False): if isinstance(source_suffix, string_types): SUFFIX = source_suffix elif isinstance(source_suffix, (list, tuple)): # Sphinx >= 1.3 supports list/tuple to define multiple suffixes SUFFIX = source_suffix[0] elif isinstance(source_suffix, dict): # Sphinx >= 1.8 supports a mapping dictionary for multiple suffixes SUFFIX = list(source_suffix.keys())[0] # make a ``list()`` for py2/py3 compatibility else: # default to .rst SUFFIX = '.rst' else: SUFFIX = '.rst' # Add RTD Static Path. Add to the end because it overwrites previous files. if not 'html_static_path' in globals(): html_static_path = [] if os.path.exists('_static'): html_static_path.append('_static') # Define this variable in case it's not defined by the user. # It defaults to `alabaster` which is the default from Sphinx. # https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_theme html_theme = globals().get('html_theme', 'alabaster') #Add project information to the template context. context = { 'html_theme': html_theme, 'current_version': "latest", 'version_slug': "latest", 'MEDIA_URL': "https://media.readthedocs.com/media/", 'STATIC_URL': "https://assets.readthedocs.com/", 'PRODUCTION_DOMAIN': "readthedocs.com", 'proxied_static_path': "/_/static/", 'versions': [ ("latest", "/en/latest/"), ], 'downloads': [ ("pdf", "//canonical-pebble.readthedocs-hosted.com/_/downloads/en/latest/pdf/"), ], 'subprojects': [ ], 'slug': 'canonical-pebble', 'name': u'pebble', 'rtd_language': u'en', 'programming_language': u'words', 'canonical_url': '', 'analytics_code': 'None', 'single_version': False, 'conf_py_path': '/docs/', 'api_host': 'https://readthedocs.com', 'github_user': 'canonical', 'proxied_api_host': '/_', 'github_repo': 'pebble', 'github_version': 'master', 'display_github': True, 'bitbucket_user': 'None', 'bitbucket_repo': 'None', 'bitbucket_version': 'master', 'display_bitbucket': False, 'gitlab_user': 'None', 'gitlab_repo': 'None', 'gitlab_version': 'master', 'display_gitlab': False, 'READTHEDOCS': True, 'using_theme': (html_theme == "default"), 'new_theme': (html_theme == "sphinx_rtd_theme"), 'source_suffix': SUFFIX, 'ad_free': False, 'docsearch_disabled': False, 'user_analytics_code': '', 'global_analytics_code': 'UA-17997319-2', 'commit': '43000386', } # For sphinx >=1.8 we can use html_baseurl to set the canonical URL. # https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_baseurl if version_info >= (1, 8): if not globals().get('html_baseurl'): html_baseurl = context['canonical_url'] context['canonical_url'] = None if 'html_context' in globals(): for key in context: if key not in html_context: html_context[key] = context[key] else: html_context = context # Add custom RTD extension if 'extensions' in globals(): # Insert at the beginning because it can interfere # with other extensions. # See https://github.com/rtfd/readthedocs.org/pull/4054 extensions.insert(0, "readthedocs_ext.readthedocs") else: extensions = ["readthedocs_ext.readthedocs"] # Add External version warning banner to the external version documentation if 'branch' == 'external': extensions.insert(1, "readthedocs_ext.external_version_warning") readthedocs_vcs_url = 'None' readthedocs_build_url = 'https://readthedocs.com/projects/canonical-pebble/builds/2368944/' project_language = 'en' # User's Sphinx configurations language_user = globals().get('language', None) latex_engine_user = globals().get('latex_engine', None) latex_elements_user = globals().get('latex_elements', None) # Remove this once xindy gets installed in Docker image and XINDYOPS # env variable is supported # https://github.com/rtfd/readthedocs-docker-images/pull/98 latex_use_xindy = False chinese = any([ language_user in ('zh_CN', 'zh_TW'), project_language in ('zh_CN', 'zh_TW'), ]) japanese = any([ language_user == 'ja', project_language == 'ja', ]) if chinese: latex_engine = latex_engine_user or 'xelatex' latex_elements_rtd = { 'preamble': '\\usepackage[UTF8]{ctex}\n', } latex_elements = latex_elements_user or latex_elements_rtd elif japanese: latex_engine = latex_engine_user or 'platex' # Make sure our build directory is always excluded exclude_patterns = globals().get('exclude_patterns', []) exclude_patterns.extend(['_build']) [rtd-command-info] start-time: 2024-07-23T23:01:16.726739Z, end-time: 2024-07-23T23:01:22.033680Z, duration: 5, exit-code: 0 python -m sphinx -T -W --keep-going -b dirhtml -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/html Running Sphinx v7.4.7 loading translations [en]... done matplotlib is not installed, social cards will not be generated making output directory... done myst v3.0.1: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions={'linkify', 'deflist', 'substitution'}, disable_syntax=[], all_links_external=False, links_external_new_tab=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, fence_as_directive=set(), number_code_blocks=[], title_to_header=False, heading_anchors=0, heading_slug_func=None, html_meta={}, footnote_transition=True, words_per_minute=200, substitutions={}, linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=True, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', enable_checkboxes=False, suppress_warnings=[], highlight_code_blocks=True) building [mo]: targets for 0 po files that are out of date writing output... building [dirhtml]: targets for 38 source files that are out of date updating environment: [new config] 38 added, 0 changed, 0 removed reading sources... [ 3%] explanation/api-and-clients reading sources... [ 5%] explanation/general-model reading sources... [ 8%] explanation/index reading sources... [ 11%] how-to/index reading sources... [ 13%] how-to/install-pebble reading sources... [ 16%] how-to/service-dependencies reading sources... [ 18%] index reading sources... [ 21%] reference/changes-and-tasks/changes-and-tasks reading sources... [ 24%] reference/changes-and-tasks/pebble-changes reading sources... [ 26%] reference/changes-and-tasks/pebble-tasks reading sources... [ 29%] reference/cli-commands/cli-commands reading sources... [ 32%] reference/cli-commands/help reading sources... [ 34%] reference/cli-commands/logs reading sources... [ 37%] reference/cli-commands/replan reading sources... [ 39%] reference/cli-commands/run reading sources... [ 42%] reference/cli-commands/services reading sources... [ 45%] reference/cli-commands/start reading sources... [ 47%] reference/cli-commands/stop reading sources... [ 50%] reference/health-checks reading sources... [ 53%] reference/index reading sources... [ 55%] reference/layer-specification reading sources... [ 58%] reference/layers reading sources... [ 61%] reference/log-forwarding reading sources... [ 63%] reference/notices/notices reading sources... [ 66%] reference/notices/pebble-notice reading sources... [ 68%] reference/notices/pebble-notices reading sources... [ 71%] reference/notices/pebble-notify reading sources... [ 74%] reference/pebble-in-containers/pebble-exec reading sources... [ 76%] reference/pebble-in-containers/pebble-in-containers reading sources... [ 79%] reference/pebble-in-containers/pebble-ls reading sources... [ 82%] reference/pebble-in-containers/pebble-mkdir reading sources... [ 84%] reference/pebble-in-containers/pebble-pull reading sources... [ 87%] reference/pebble-in-containers/pebble-push reading sources... [ 89%] reference/pebble-in-containers/pebble-rm reading sources... [ 92%] reference/service-auto-restart reading sources... [ 95%] reuse/install reading sources... [ 97%] reuse/verify reading sources... [100%] tutorial/getting-started looking for now-outdated files... none found pickling environment... done checking consistency... done preparing documents... done copying assets... copying static files... done copying extra files... done copying assets: done writing output... [ 3%] explanation/api-and-clients writing output... [ 5%] explanation/general-model writing output... [ 8%] explanation/index writing output... [ 11%] how-to/index writing output... [ 13%] how-to/install-pebble writing output... [ 16%] how-to/service-dependencies writing output... [ 18%] index writing output... [ 21%] reference/changes-and-tasks/changes-and-tasks writing output... [ 24%] reference/changes-and-tasks/pebble-changes writing output... [ 26%] reference/changes-and-tasks/pebble-tasks writing output... [ 29%] reference/cli-commands/cli-commands writing output... [ 32%] reference/cli-commands/help writing output... [ 34%] reference/cli-commands/logs writing output... [ 37%] reference/cli-commands/replan writing output... [ 39%] reference/cli-commands/run writing output... [ 42%] reference/cli-commands/services writing output... [ 45%] reference/cli-commands/start writing output... [ 47%] reference/cli-commands/stop writing output... [ 50%] reference/health-checks writing output... [ 53%] reference/index writing output... [ 55%] reference/layer-specification writing output... [ 58%] reference/layers writing output... [ 61%] reference/log-forwarding writing output... [ 63%] reference/notices/notices writing output... [ 66%] reference/notices/pebble-notice writing output... [ 68%] reference/notices/pebble-notices writing output... [ 71%] reference/notices/pebble-notify writing output... [ 74%] reference/pebble-in-containers/pebble-exec writing output... [ 76%] reference/pebble-in-containers/pebble-in-containers writing output... [ 79%] reference/pebble-in-containers/pebble-ls writing output... [ 82%] reference/pebble-in-containers/pebble-mkdir writing output... [ 84%] reference/pebble-in-containers/pebble-pull writing output... [ 87%] reference/pebble-in-containers/pebble-push writing output... [ 89%] reference/pebble-in-containers/pebble-rm writing output... [ 92%] reference/service-auto-restart writing output... [ 95%] reuse/install writing output... [ 97%] reuse/verify writing output... [100%] tutorial/getting-started generating indices... genindex done writing additional pages... search done dumping search index in English (code: en)... done dumping object inventory... done Updating searchtools for Read the Docs search... build succeeded. The HTML pages are in ../_readthedocs/html. [rtd-command-info] start-time: 2024-07-23T23:01:22.125102Z, end-time: 2024-07-23T23:01:23.379991Z, duration: 1, exit-code: 0 python -m sphinx -T -b latex -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/pdf Running Sphinx v7.4.7 loading translations [en]... done matplotlib is not installed, social cards will not be generated making output directory... done loading pickled environment... done myst v3.0.1: MdParserConfig(commonmark_only=False, gfm_only=False, enable_extensions={'deflist', 'substitution', 'linkify'}, disable_syntax=[], all_links_external=False, links_external_new_tab=False, url_schemes=('http', 'https', 'mailto', 'ftp'), ref_domains=None, fence_as_directive=set(), number_code_blocks=[], title_to_header=False, heading_anchors=0, heading_slug_func=None, html_meta={}, footnote_transition=True, words_per_minute=200, substitutions={}, linkify_fuzzy_links=True, dmath_allow_labels=True, dmath_allow_space=True, dmath_allow_digits=True, dmath_double_inline=False, update_mathjax=True, mathjax_classes='tex2jax_process|mathjax_process|math|output_area', enable_checkboxes=False, suppress_warnings=[], highlight_code_blocks=True) building [mo]: targets for 0 po files that are out of date writing output... building [latex]: all documents updating environment: 0 added, 0 changed, 0 removed reading sources... looking for now-outdated files... none found copying TeX support files... copying TeX support files... done processing pebble.tex... index tutorial/getting-started how-to/index how-to/install-pebble how-to/service-dependencies explanation/index explanation/general-model explanation/api-and-clients reference/index reference/changes-and-tasks/changes-and-tasks reference/changes-and-tasks/pebble-changes reference/changes-and-tasks/pebble-tasks reference/cli-commands/cli-commands reference/cli-commands/help reference/cli-commands/logs reference/cli-commands/replan reference/cli-commands/run reference/cli-commands/services reference/cli-commands/start reference/cli-commands/stop reference/health-checks reference/layers reference/layer-specification reference/log-forwarding reference/notices/notices reference/notices/pebble-notice reference/notices/pebble-notices reference/notices/pebble-notify reference/service-auto-restart reference/pebble-in-containers/pebble-in-containers reference/pebble-in-containers/pebble-exec reference/pebble-in-containers/pebble-ls reference/pebble-in-containers/pebble-mkdir reference/pebble-in-containers/pebble-rm reference/pebble-in-containers/pebble-push reference/pebble-in-containers/pebble-pull resolving references... done writing... done Missing searchtools: /home/docs/checkouts/readthedocs.org/user_builds/canonical-pebble/checkouts/latest/_readthedocs/pdf/_static/searchtools.js build succeeded. The LaTeX files are in ../_readthedocs/pdf. Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically). [rtd-command-info] start-time: 2024-07-23T23:01:23.459280Z, end-time: 2024-07-23T23:01:23.521526Z, duration: 0, exit-code: 0 cat latexmkrc $latex = 'latex ' . $ENV{'LATEXOPTS'} . ' %O %S'; $pdflatex = 'pdflatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; $lualatex = 'lualatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; $xelatex = 'xelatex --no-pdf ' . $ENV{'LATEXOPTS'} . ' %O %S'; $makeindex = 'makeindex -s python.ist %O -o %D %S'; add_cus_dep( "glo", "gls", 0, "makeglo" ); sub makeglo { return system( "makeindex -s gglo.ist -o '$_[0].gls' '$_[0].glo'" ); } [rtd-command-info] start-time: 2024-07-23T23:01:23.669384Z, end-time: 2024-07-23T23:01:29.743419Z, duration: 6, exit-code: 0 latexmk -r latexmkrc -pdf -f -dvi- -ps- -jobname=canonical-pebble -interaction=nonstopmode Use of uninitialized value in concatenation (.) or string at (eval 10) line 1. Use of uninitialized value in concatenation (.) or string at (eval 10) line 2. Use of uninitialized value in concatenation (.) or string at (eval 10) line 3. Use of uninitialized value in concatenation (.) or string at (eval 10) line 4. Subroutine makeglo redefined at (eval 11) line 7. Use of uninitialized value in concatenation (.) or string at (eval 11) line 1. Use of uninitialized value in concatenation (.) or string at (eval 11) line 2. Use of uninitialized value in concatenation (.) or string at (eval 11) line 3. Use of uninitialized value in concatenation (.) or string at (eval 11) line 4. Rc files read: /etc/LatexMk latexmkrc latexmkrc Latexmk: This is Latexmk, John Collins, 20 November 2021, version: 4.76. Rule 'pdflatex': File changes, etc: Changed files, or newly in use since previous run(s): 'pebble.tex' ------------ Run number 1 of rule 'pdflatex' ------------ ------------ Running 'pdflatex -interaction=nonstopmode -recorder --jobname="canonical-pebble" "pebble.tex"' ------------ Latexmk: applying rule 'pdflatex'... This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2022/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./pebble.tex LaTeX2e <2021-11-15> patch level 1 L3 programming layer <2022-01-21> (./sphinxmanual.cls Document Class: sphinxmanual 2019/12/01 v2.3.0 Document class (Sphinx manual) (/usr/share/texlive/texmf-dist/tex/latex/base/report.cls Document Class: report 2021/10/04 v1.4n Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size10.clo))) (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/cmap/cmap.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty<>) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amssymb.sty (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amsfonts.sty)) (/usr/share/texlive/texmf-dist/tex/generic/babel/babel.sty (/usr/share/texlive/texmf-dist/tex/generic/babel/txtbabel.def) (/usr/share/texlive/texmf-dist/tex/generic/babel-english/english.ldf)) (/usr/share/texmf/tex/latex/tex-gyre/tgtermes.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty) (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvsetkeys/kvsetkeys.sty))) (/usr/share/texmf/tex/latex/tex-gyre/tgheros.sty) (/usr/share/texlive/texmf-dist/tex/latex/fncychap/fncychap.sty) (./sphinx.sty (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def)) (./sphinxoptionshyperref.sty) (./sphinxoptionsgeometry.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/textcomp.sty) (/usr/share/texlive/texmf-dist/tex/latex/float/float.sty) (/usr/share/texlive/texmf-dist/tex/latex/wrapfig/wrapfig.sty) (/usr/share/texlive/texmf-dist/tex/latex/capt-of/capt-of.sty) (/usr/share/texlive/texmf-dist/tex/latex/tools/multicol.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg))) (./sphinxlatexgraphics.sty) (./sphinxpackageboxes.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.cfg) (/usr/share/texlive/texmf-dist/tex/latex/pict2e/p2e-pdftex.def)) (/usr/share/texlive/texmf-dist/tex/latex/ellipse/ellipse.sty)) (./sphinxlatexadmonitions.sty (/usr/share/texlive/texmf-dist/tex/latex/framed/framed.sty)) (./sphinxlatexliterals.sty (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/alltt.sty) (/usr/share/texlive/texmf-dist/tex/latex/upquote/upquote.sty) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty)) (./sphinxlatexshadowbox.sty) (./sphinxlatexcontainers.sty) (./sphinxhighlight.sty) (./sphinxlatextables.sty (/usr/share/texlive/texmf-dist/tex/latex/tabulary/tabulary.sty (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/varwidth/varwidth.sty) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/booktabs/booktabs.sty)) (./sphinxlatexnumfig.sty) (./sphinxlatexlists.sty) (./sphinxpackagefootnote.sty ) (./sphinxlatexindbibtoc.sty (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty)) (./sphinxlatexstylepage.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip-2001-04-09.sty)) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty)) (./sphinxlatexstyleheadings.sty (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty)) (./sphinxlatexstyletext.sty) (./sphinxlatexobjects.sty)) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/ifvtex.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty))) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/infwarerr/infwarerr.sty)) (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/pdfescape/pdfescape.sty) (/usr/share/texlive/texmf-dist/tex/latex/hycolor/hycolor.sty) (/usr/share/texlive/texmf-dist/tex/latex/letltxmacro/letltxmacro.sty) (/usr/share/texlive/texmf-dist/tex/latex/auxhook/auxhook.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref-langpatches.def) (/usr/share/texlive/texmf-dist/tex/generic/intcalc/intcalc.sty) (/usr/share/texlive/texmf-dist/tex/generic/etexcmds/etexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/puenc.def) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty) (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty (/usr/share/texlive/texmf-dist/tex/generic/bigintcalc/bigintcalc.sty)) (/usr/share/texlive/texmf-dist/tex/latex/base/atbegshi-ltx.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def (/usr/share/texlive/texmf-dist/tex/latex/base/atveryend-ltx.sty) (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/generic/uniquecounter/uniquecounter.sty))) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/hypcap.sty) (./sphinxmessages.sty) Writing index file canonical-pebble.idx (/usr/share/texmf/tex/latex/tex-gyre/t1qtm.fd) (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def) (./canonical-pebble.aux) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-generic-help er.sty (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-mapping.def) )) *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (/usr/share/texmf/tex/latex/tex-gyre/t1qhv.fd)<><><><> (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd) [1{/var/lib/texmf/fo nts/map/pdftex/updmap/pdftex.map}] [2] [1] [2] [1] [2] Chapter 1. LaTeX Warning: Hyper reference `tutorial/getting-started::doc' on page 3 undefi ned on input line 113. LaTeX Warning: Hyper reference `how-to/index::doc' on page 3 undefined on input line 134. LaTeX Warning: Hyper reference `explanation/index::doc' on page 3 undefined on input line 173. LaTeX Warning: Hyper reference `reference/index::doc' on page 3 undefined on in put line 194. [3] [4] Chapter 2. (/usr/share/texmf/tex/latex/tex-gyre/ts1qtm.fd) LaTeX Warning: Hyper reference `tutorial/getting-started:next-steps' on page 5 undefined on input line 248. LaTeX Warning: Hyper reference `how-to/install-pebble:how-to-install-pebble' on page 5 undefined on input line 263. (/usr/share/texlive/texmf-dist/tex/latex/txfonts/t1txtt.fd) [5] Underfull \hbox (badness 7415) in paragraph at lines 310--313 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree1.fd) [6] Underfull \hbox (badness 10000) in paragraph at lines 374--379 []\T1/txtt/m/n/10 user@host:~$ pebble run 2024[]06[]02T11:30:02.925Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 2024[]06[]02T11:30:02.936Z [pebble] POST /v1/services 10.751704 ms 2022024[]06[]02T11:30:02. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 936Z [pebble] Started default services with change 77.2024[]06[ ]02T11:30:02.942Z [pebble] (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree2.fd) Underfull \hbox (badness 10000) in paragraph at lines 418--423 []\T1/txtt/m/n/10 user@host:~$ pebble stop http[]server Service Startup Current Sincehttp[]server enabled [7] Underfull \hbox (badness 7415) in paragraph at lines 470--475 []\T1/txtt/m/n/10 user@host:~$ pebble add layer1 $PEBBLE/layers/002[]another[]h ttp[]server.yaml Layer "layer1" Underfull \hbox (badness 10000) in paragraph at lines 470--475 \T1/txtt/m/n/10 added successfully from "/home/ubuntu/PEBBLE_HOME/layers/002[]a nother[]http[]server.yaml" Underfull \hbox (badness 10000) in paragraph at lines 498--503 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2024[]06[]02T11:40:39Z INFO Servic e "http[]server" already [8] LaTeX Warning: Hyper reference `reference/cli-commands/run::doc' on page 9 unde fined on input line 520. LaTeX Warning: Hyper reference `reference/cli-commands/services::doc' on page 9 undefined on input line 524. LaTeX Warning: Hyper reference `reference/cli-commands/start::doc' on page 9 un defined on input line 524. LaTeX Warning: Hyper reference `reference/cli-commands/stop::doc' on page 9 und efined on input line 524. LaTeX Warning: Hyper reference `reference/cli-commands/replan::doc' on page 9 u ndefined on input line 528. LaTeX Warning: Hyper reference `reference/layers::doc' on page 9 undefined on i nput line 532. LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 9 u ndefined on input line 536. LaTeX Warning: Hyper reference `how-to/install-pebble:install-pebble-binary' on page 9 undefined on input line 555. LaTeX Warning: Hyper reference `how-to/install-pebble:install-pebble-from-sourc e' on page 9 undefined on input line 559. [9] LaTeX Warning: Hyper reference `reference/cli-commands/help:reference-pebble-he lp-command' on page 10 undefined on input line 639. Underfull \hbox (badness 7415) in paragraph at lines 635--640 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe [10] Underfull \hbox (badness 10000) in paragraph at lines 734--737 []\T1/txtt/m/n/10 user@host:~$ pebble changes [][]help Usage: pebble changes [c hanges[]OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 The changes command displays a summary of system changes perfor med recently. [changes Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 command options] [][]abs[]time Display absolute times (in RFC 3 339 format). Otherwise, [11] Underfull \hbox (badness 10000) in paragraph at lines 766--769 []\T1/txtt/m/n/10 user@host:~$ pebble tasks [][]help Usage: pebble tasks [tasks []OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 The tasks command displays a summary of tasks associated with a n individualchange that Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 happened recently. [tasks command options] [][]abs[]time Displa y absolute times (in RFC 3339 Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. [][]last= Select Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 last change of given type (install, refresh, remove, try, auto[ ]refresh, etc.). A question Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 mark at the end of the type means to do nothing (instead of ret urning an error) if no Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 change of the given type is found. Note the question mark could need protecting from the Underfull \hbox (badness 10000) in paragraph at lines 776--780 []\T1/txtt/m/n/10 user@host:~$ pebble tasks 3 Status Spawn Ready SummaryDone to day at 15:26 NZDT today at Underfull \hbox (badness 10000) in paragraph at lines 776--780 \T1/txtt/m/n/10 15:26 NZDT Stop service "srv1"Done today at 15:26 NZDT today at 15:26 NZDT Stop service [12] (/usr/share/texlive/texmf-dist/tex/latex/txfonts/ts1txtt.fd) Underfull \hbox (badness 10000) in paragraph at lines 832--835 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]help Usage: pebble logs [logs[]O PTIONS] [...] The Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 logs command fetches buffered logs from the given services (or all servicesif none Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified) and displays them in chronological order. [logs command options] []f, Underfull \hbox (badness 10000) in paragraph at lines 832--835 [][]\T1/txtt/m/n/10 follow Follow (tail) logs for given services until Ctrl[]C is pressed. If no services Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified, show logs from all services running when the com mand starts. [][]format= Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 Output format: "text" (default) or "json" (JSON lines). []n= Nu mber of logs to show Underfull \hbox (badness 10000) in paragraph at lines 842--847 []\T1/txtt/m/n/10 user@host:~$ pebble logs 2022[]11[]14T01:35:06.979Z [srv1] Lo g 0 from Underfull \hbox (badness 10000) in paragraph at lines 842--847 \T1/txtt/m/n/10 srv12022[]11[]14T01:35:08.041Z [srv2] Log 0 from srv22022[]11[] 14T01:35:09.982Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 849--854 []\T1/txtt/m/n/10 user@host:~$ pebble logs []f 2022[]11[]14T01:37:56.936Z [srv1 ] Log 0 from Underfull \hbox (badness 10000) in paragraph at lines 849--854 \T1/txtt/m/n/10 srv12022[]11[]14T01:37:57.978Z [srv2] Log 0 from srv22022[]11[] 14T01:37:59.939Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 856--861 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]format=json {"time":"2022[]11[]1 4T01:39:10.886Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv1","message":"Log 0 from srv1"}{"time":"2022[]11[ ]14T01:39:11.943Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv2","message":"Log 0 from srv2"}{"time":"2022[]11[ ]14T01:39:13.889Z", Underfull \hbox (badness 10000) in paragraph at lines 863--867 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]verbose 2022[]10[]26T01:41:32.805 Z [pebble] Started daemon. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 2022[]10[]26T01:41:32.835Z [pebble] POST /v1/services 29.743632 ms 2022022[]10[]26T01:41:32. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 835Z [pebble] Started default services with change 7.2022[]10[] 26T01:41:32.849Z [pebble] Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 Service "srv1" starting: python3 []u /path/to/srv1.py2022[]10[] 26T01:41:32.866Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 0 from srv12022[]10[]26T01:41:35.870Z [srv1] Log 1 from srv1202 2[]10[]26T01:41:38.873Z [srv1] [13] Underfull \hbox (badness 10000) in paragraph at lines 878--881 []\T1/txtt/m/n/10 user@host:~$ pebble replan [][]help Usage: pebble replan [rep lan[]OPTIONS] The replan Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 command starts, stops, or restarts services that have changed,s o that running services Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 exactly match the desired configuration in thecurrent plan. [re plan command options] Underfull \hbox (badness 7415) in paragraph at lines 904--909 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:06:50+02:00 INFO S ervice "srv1" already started. Underfull \hbox (badness 7415) in paragraph at lines 911--916 []\T1/txtt/m/n/10 user@host:~$ pebble add lay1 layer.yaml Layer "lay1" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 925--930 []\T1/txtt/m/n/10 user@host:~$ pebble add lay2 layer.yaml Layer "lay2" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 932--935 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:11:22+02:00 INFO S ervice "srv1" already started. [14] Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]help Usage: pebble run [run[]OPTI ONS] The run command starts Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Pebble and runs the configured environment. Additional argument s may be provided to the Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 service command with the [][]args option, whichmust be terminat ed with ";" unless there Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 are no further program options. These argumentsare appended to the end of the service Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 command, and replace any default arguments definedin the servic e plan. For example: Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 pebble run [][]args myservice [][]port 8080 []; [][]hold [run c ommand options] [][]create[]dirs Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Create Pebble directory on startup if it doesn\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 t exist [][]hold Do not start default Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 services automatically [][]http= Start HTTP API listening on th is address (e.g., ":4000") Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 v, [][]verbose Log all output from services to stdout [][]arg s= Provide additional arguments LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 15 undefined on input line 959. Underfull \hbox (badness 10000) in paragraph at lines 980--983 []\T1/txtt/m/n/10 user@host:~$ pebble run 2022[]10[]26T01:18:26.904Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 2022[]10[]26T01:18:26.921Z [pebble] POST /v1/services 15.53132m s 2022022[]10[]26T01:18:26. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 921Z [pebble] Started default services with change 50.2022[]10[ ]26T01:18:26.936Z [pebble] [15] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 []\T1/txtt/m/n/10 user@host:~$ pebble services [][]help Usage:Usage: pebble ser vices [services[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 [...] The services command lists status information ab out the services Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 specified, orabout all services if none are specified. [service s command options] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 [][]\T1/txtt/m/n/10 abs[]time Display absolute times (in RFC 3339 format). Othe rwise, display relative times Underfull \hbox (badness 10000) in paragraph at lines 1059--1064 []\T1/txtt/m/n/10 user@host:~$ pebble services Service Startup Currentsrv1 enab led activesrv2 disabled [16] LaTeX Warning: Hyper reference `reference/service-auto-restart::doc' on page 17 undefined on input line 1078. Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 []\T1/txtt/m/n/10 user@host:~$ pebble start [][]help Usage: pebble services [se rvices[]OPTIONS] [.. Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 .] The services command lists status information about the serv ices specified, orabout Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 all services if none are specified. [services command options] [][]abs[]time Display Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 absolute times (in RFC 3339 format). Otherwise, display relativ e times up to 60 days, [17] Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 []\T1/txtt/m/n/10 user@host:~$ pebble stop [][]help Usage: pebble stop [stop[]O PTIONS] ... The stop Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 command stops the service with the provided name andany other s ervice that depends on it, Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 in the correct order. [stop command options] [][]no[]wait Do no t wait for the operation to [18] LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 19 undefined on input line 1217. [19] Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 []\T1/txtt/m/n/10 user@host:~$ pebble checks Check Level Status Failures Change up alive up 0/1 10online Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 ready down 1/3 13 (dial tcp 127.0.0.1:8000: connect: connection refused)test [] down Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 42/3 14 (Get "http://localhost:8080/": dial t... run "pebble ta sks 14" for more) \T1/qtm/m/n/10 The LaTeX Warning: Hyper reference `reference/changes-and-tasks/changes-and-tasks:: doc' on page 20 undefined on input line 1299. [20] LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 21 undefined on input line 1344. [21] LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 22 undefined on input line 1386. [22] [23] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [24] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [25] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [26] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [27] LaTeX Warning: Hyper reference `reference/layer-specification::doc' on page 28 undefined on input line 1731. [28] [29] [30] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 []\T1/txtt/m/n/10 user@host:~$ pebble notice [][]help Usage: pebble notice [not ice[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 [] The notice command fetches a single notice, either by I D (1[]arg variant), orby Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 unique type and key combination (2[]arg variant). [notice comma nd options] [][]uid= Look up [31] Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 []\T1/txtt/m/n/10 user@host:~$ pebble notice 1 id: "1"user[]id: 1000type: custo mkey: example.com/ Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 foofirst[]occurred: 2023[]09[]15T04:16:09.179395298Zlast[]occur red: 2023[]09[]15T04:16:19. Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 487035209Zlast[]repeated: 2023[]09[]15T04:16:09.179395298Zoccur rences: 3expire[]after: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 []\T1/txtt/m/n/10 user@host:~$ pebble notice custom other.com/bar id: "2"user[] id: publictype: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 customkey: other.com/barfirst[]occurred: 2023[]09[]15T04:16:17. 180049768Zlast[]occurred: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 2023[]09[]15T04:16:17.180049768Zlast[]repeated: 2023[]09[]15T04 :16:17.180049768Zoccurrences: Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 []\T1/txtt/m/n/10 user@host:~$ pebble notices [][]help Usage: pebble notices [n otices[]OPTIONS] The notices Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 command lists notices not yet acknowledged, ordered by thelast[ ]repeated time (oldest Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 first). After it runs, the notices that were shownmay then be a cknowledged by running Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 pebble okay\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 . When a notice repeats, itneeds to be acknowledged again. [notices command Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 options] [][]abs[]time Display absolute times (in RFC 3339 form at). Otherwise, display Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 relative times up to 60 days, then YYYY[]MM[]DD. [][]users= Sho w all notices with any user ID Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 (admin only; cannot be used with [][]uid) [][]uid= Only list no tices with this user ID (admin Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 only; cannot be used with [][]users) [][]type= Only list notice s of this type (multiple Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 allowed) [][]key= Only list notices with this key (multiple all owed) [][]timeout= Wait up Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 []\T1/txtt/m/n/10 user@host:~$ pebble notices ID User Type Key First Repeated O ccurrences1 1000 custom Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 \T1/txtt/m/n/10 example.com/foo today at 16:16 NZST today at 16:16 NZST 32 publ ic custom other.com/bar [32] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 []\T1/txtt/m/n/10 user@host:~$ pebble notify [][]help Usage: pebble notify [not ify[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 [...] The notify command records a custom notice wi th the specified key and Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 optionaldata fields. [notify command options] [][]repeat[]after = Prevent notice with same Underfull \hbox (badness 10000) in paragraph at lines 2003--2007 []\T1/txtt/m/n/10 user@host:~$ pebble notify other.com/bar name=value email=joh n@smith.com Recorded notice [33] LaTeX Warning: Hyper reference `reference/pebble-in-containers/pebble-exec::doc ' on page 34 undefined on input line 2059. Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]help Usage: pebble exec [exec[]O PTIONS] The exec Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 command runs a remote command and waits for it to finish. The l ocalstdin is sent as the Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 input to the remote process, while the remote stdout andstderr are output locally. To Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 avoid confusion, exec options may be separated from the command and itsarguments using Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 "[][]", for example: pebble exec [][]timeout 10s [][] echo []n foo bar [exec command options] Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 w= Working directory to run command in [][]env= Environment v ariable to set (in \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 FOO=bar\TS1/txtt/m/n/10 ' Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 format) [][]uid= User ID to run command as [][]user= Username t o run command as (user\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 UID must match uid if both present) [][]gid= Group ID to run co mmand as [][]group= Group Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 name to run command as (group\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s GID must match gid if both present) [][]timeout= Timeout Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 after which to terminate command [][]context= Inherit the conte xt of the named service Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 (overridden by []w, [][]env, [][]uid/user, [][]gid/group) []t A llocate remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 and connect stdout to it (default if stdout is a TTY) []T Disab le remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 allocation []i Interactive mode: connect stdin to the pseudo[]t erminal (default if stdin Underfull \hbox (badness 10000) in paragraph at lines 2093--2096 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]timeout 1s [][] sleep 3 error: c annot perform the following [34] Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 []\T1/txtt/m/n/10 user@host:~$ pebble ls [][]help Usage: pebble ls [ls[]OPTIONS ] The ls command lists Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 entries in the filesystem at the specified path. A glob pattern may be specified for Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 the last path element. [ls command options] [][]abs[]time Displ ay absolute times (in RFC Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 3339 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. []d List Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 []\T1/txtt/m/n/10 user@host:~$ pebble mkdir [][]help Usage: pebble mkdir [mkdir []OPTIONS] The mkdir Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 command creates the specified directory. [mkdir command options ] []p Create parent Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 directories as needed []m= Override mode bits (3[]digit octal) [][]uid= Use specified user Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 ID [][]user= Use specified username [][]gid= Use specified grou p ID [][]group= Use specified Underfull \hbox (badness 10000) in paragraph at lines 2147--2151 \T1/txtt/m/n/10 a file or directory. [rm command options] []r Remove all files and directories recursively [35] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 []\T1/txtt/m/n/10 user@host:~$ pebble push [][]help Usage: pebble push [push[]O PTIONS] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 The push command transfers a file to the remote system. [push command Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 options] []p Create parent directories for the file []m= Overri de mode bits (3[]digit octal) Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 [][]\T1/txtt/m/n/10 uid= Use specified user ID [][]user= Use specified username [][]gid= Use specified group ID Underfull \hbox (badness 10000) in paragraph at lines 2177--2180 []\T1/txtt/m/n/10 user@host:~$ pebble pull [][]help Usage: pebble pull The pull No file canonical-pebble.ind. [36] (./canonical-pebble.aux) LaTeX Warning: There were undefined references. LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right. Package rerunfilecheck Warning: File `canonical-pebble.out' has changed. (rerunfilecheck) Rerun to get outlines right (rerunfilecheck) or use package `bookmark'. ) (see the transcript file for additional information){/usr/share/texlive/texmf-d ist/fonts/enc/dvips/base/8r.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/ fontawesome5/fa5free2.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/fontaw esome5/fa5free1.enc}{/usr/share/texmf/fonts/enc/dvips/tex-gyre/q-ts1.enc}{/usr/ share/texmf/fonts/enc/dvips/tex-gyre/q-ec.enc} Output written on canonical-pebble.pdf (40 pages, 249336 bytes). Transcript written on canonical-pebble.log. Latexmk: Index file 'canonical-pebble.idx' was written Latexmk: Missing input file 'canonical-pebble.ind' (or dependence on it) from following: 'No file canonical-pebble.ind.' Latexmk: References changed. Latexmk: References changed. Latexmk: Log file says output to 'canonical-pebble.pdf' Rule 'makeindex canonical-pebble.idx': File changes, etc: Changed files, or newly in use since previous run(s): 'canonical-pebble.idx' ------------ Run number 1 of rule 'makeindex canonical-pebble.idx' ------------ Latexmk: Examining 'canonical-pebble.log' === TeX engine is 'pdfTeX' Latexmk: applying rule 'makeindex canonical-pebble.idx'... ------------ Running 'makeindex -s python.ist -o "canonical-pebble.ind" "canonical-pebble.idx"' ------------ This is makeindex, version 2.15 [TeX Live 2022/dev] (kpathsea + Thai support). Scanning style file ./python.ist.......done (7 attributes redefined, 0 ignored). Scanning input file canonical-pebble.idx...done (0 entries accepted, 0 rejected). Nothing written in canonical-pebble.ind. Transcript written in canonical-pebble.ilg. Rule 'pdflatex': File changes, etc: Changed files, or newly in use since previous run(s): 'canonical-pebble.aux' 'canonical-pebble.ind' 'canonical-pebble.out' ------------ Run number 2 of rule 'pdflatex' ------------ Latexmk: applying rule 'pdflatex'... ------------ Running 'pdflatex -interaction=nonstopmode -recorder --jobname="canonical-pebble" "pebble.tex"' ------------ This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2022/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./pebble.tex LaTeX2e <2021-11-15> patch level 1 L3 programming layer <2022-01-21> (./sphinxmanual.cls Document Class: sphinxmanual 2019/12/01 v2.3.0 Document class (Sphinx manual) (/usr/share/texlive/texmf-dist/tex/latex/base/report.cls Document Class: report 2021/10/04 v1.4n Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size10.clo))) (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/cmap/cmap.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty<>) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amssymb.sty (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amsfonts.sty)) (/usr/share/texlive/texmf-dist/tex/generic/babel/babel.sty (/usr/share/texlive/texmf-dist/tex/generic/babel/txtbabel.def) (/usr/share/texlive/texmf-dist/tex/generic/babel-english/english.ldf)) (/usr/share/texmf/tex/latex/tex-gyre/tgtermes.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty) (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvsetkeys/kvsetkeys.sty))) (/usr/share/texmf/tex/latex/tex-gyre/tgheros.sty) (/usr/share/texlive/texmf-dist/tex/latex/fncychap/fncychap.sty) (./sphinx.sty (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def)) (./sphinxoptionshyperref.sty) (./sphinxoptionsgeometry.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/textcomp.sty) (/usr/share/texlive/texmf-dist/tex/latex/float/float.sty) (/usr/share/texlive/texmf-dist/tex/latex/wrapfig/wrapfig.sty) (/usr/share/texlive/texmf-dist/tex/latex/capt-of/capt-of.sty) (/usr/share/texlive/texmf-dist/tex/latex/tools/multicol.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg))) (./sphinxlatexgraphics.sty) (./sphinxpackageboxes.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.cfg) (/usr/share/texlive/texmf-dist/tex/latex/pict2e/p2e-pdftex.def)) (/usr/share/texlive/texmf-dist/tex/latex/ellipse/ellipse.sty)) (./sphinxlatexadmonitions.sty (/usr/share/texlive/texmf-dist/tex/latex/framed/framed.sty)) (./sphinxlatexliterals.sty (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/alltt.sty) (/usr/share/texlive/texmf-dist/tex/latex/upquote/upquote.sty) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty)) (./sphinxlatexshadowbox.sty) (./sphinxlatexcontainers.sty) (./sphinxhighlight.sty) (./sphinxlatextables.sty (/usr/share/texlive/texmf-dist/tex/latex/tabulary/tabulary.sty (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/varwidth/varwidth.sty) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/booktabs/booktabs.sty)) (./sphinxlatexnumfig.sty) (./sphinxlatexlists.sty) (./sphinxpackagefootnote.sty ) (./sphinxlatexindbibtoc.sty (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty)) (./sphinxlatexstylepage.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip-2001-04-09.sty)) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty)) (./sphinxlatexstyleheadings.sty (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty)) (./sphinxlatexstyletext.sty) (./sphinxlatexobjects.sty)) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/ifvtex.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty))) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/infwarerr/infwarerr.sty)) (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/pdfescape/pdfescape.sty) (/usr/share/texlive/texmf-dist/tex/latex/hycolor/hycolor.sty) (/usr/share/texlive/texmf-dist/tex/latex/letltxmacro/letltxmacro.sty) (/usr/share/texlive/texmf-dist/tex/latex/auxhook/auxhook.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref-langpatches.def) (/usr/share/texlive/texmf-dist/tex/generic/intcalc/intcalc.sty) (/usr/share/texlive/texmf-dist/tex/generic/etexcmds/etexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/puenc.def) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty) (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty (/usr/share/texlive/texmf-dist/tex/generic/bigintcalc/bigintcalc.sty)) (/usr/share/texlive/texmf-dist/tex/latex/base/atbegshi-ltx.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def (/usr/share/texlive/texmf-dist/tex/latex/base/atveryend-ltx.sty) (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/generic/uniquecounter/uniquecounter.sty))) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/hypcap.sty) (./sphinxmessages.sty) Writing index file canonical-pebble.idx (/usr/share/texmf/tex/latex/tex-gyre/t1qtm.fd) (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def) (./canonical-pebble.aux) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-generic-help er.sty (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-mapping.def) )) *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (./canonical-pebble.out) (./canonical-pebble.out) (/usr/share/texmf/tex/latex/tex-gyre/t1qhv.fd)<><><><> (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd) [1{/var/lib/texmf/fo nts/map/pdftex/updmap/pdftex.map}] [2] (./canonical-pebble.toc) [1] [2] [1] [2] Chapter 1. [3] [4] Chapter 2. (/usr/share/texmf/tex/latex/tex-gyre/ts1qtm.fd) (/usr/share/texlive/texmf-dist/tex/latex/txfonts/t1txtt.fd) [5] Underfull \hbox (badness 7415) in paragraph at lines 310--313 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree1.fd) [6] Underfull \hbox (badness 10000) in paragraph at lines 374--379 []\T1/txtt/m/n/10 user@host:~$ pebble run 2024[]06[]02T11:30:02.925Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 2024[]06[]02T11:30:02.936Z [pebble] POST /v1/services 10.751704 ms 2022024[]06[]02T11:30:02. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 936Z [pebble] Started default services with change 77.2024[]06[ ]02T11:30:02.942Z [pebble] (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree2.fd) Underfull \hbox (badness 10000) in paragraph at lines 418--423 []\T1/txtt/m/n/10 user@host:~$ pebble stop http[]server Service Startup Current Sincehttp[]server enabled [7] Underfull \hbox (badness 7415) in paragraph at lines 470--475 []\T1/txtt/m/n/10 user@host:~$ pebble add layer1 $PEBBLE/layers/002[]another[]h ttp[]server.yaml Layer "layer1" Underfull \hbox (badness 10000) in paragraph at lines 470--475 \T1/txtt/m/n/10 added successfully from "/home/ubuntu/PEBBLE_HOME/layers/002[]a nother[]http[]server.yaml" Underfull \hbox (badness 10000) in paragraph at lines 498--503 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2024[]06[]02T11:40:39Z INFO Servic e "http[]server" already [8] [9] Underfull \hbox (badness 7415) in paragraph at lines 635--640 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe [10] Underfull \hbox (badness 10000) in paragraph at lines 734--737 []\T1/txtt/m/n/10 user@host:~$ pebble changes [][]help Usage: pebble changes [c hanges[]OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 The changes command displays a summary of system changes perfor med recently. [changes Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 command options] [][]abs[]time Display absolute times (in RFC 3 339 format). Otherwise, [11] Underfull \hbox (badness 10000) in paragraph at lines 766--769 []\T1/txtt/m/n/10 user@host:~$ pebble tasks [][]help Usage: pebble tasks [tasks []OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 The tasks command displays a summary of tasks associated with a n individualchange that Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 happened recently. [tasks command options] [][]abs[]time Displa y absolute times (in RFC 3339 Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. [][]last= Select Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 last change of given type (install, refresh, remove, try, auto[ ]refresh, etc.). A question Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 mark at the end of the type means to do nothing (instead of ret urning an error) if no Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 change of the given type is found. Note the question mark could need protecting from the Underfull \hbox (badness 10000) in paragraph at lines 776--780 []\T1/txtt/m/n/10 user@host:~$ pebble tasks 3 Status Spawn Ready SummaryDone to day at 15:26 NZDT today at Underfull \hbox (badness 10000) in paragraph at lines 776--780 \T1/txtt/m/n/10 15:26 NZDT Stop service "srv1"Done today at 15:26 NZDT today at 15:26 NZDT Stop service [12] (/usr/share/texlive/texmf-dist/tex/latex/txfonts/ts1txtt.fd) Underfull \hbox (badness 10000) in paragraph at lines 832--835 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]help Usage: pebble logs [logs[]O PTIONS] [...] The Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 logs command fetches buffered logs from the given services (or all servicesif none Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified) and displays them in chronological order. [logs command options] []f, Underfull \hbox (badness 10000) in paragraph at lines 832--835 [][]\T1/txtt/m/n/10 follow Follow (tail) logs for given services until Ctrl[]C is pressed. If no services Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified, show logs from all services running when the com mand starts. [][]format= Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 Output format: "text" (default) or "json" (JSON lines). []n= Nu mber of logs to show Underfull \hbox (badness 10000) in paragraph at lines 842--847 []\T1/txtt/m/n/10 user@host:~$ pebble logs 2022[]11[]14T01:35:06.979Z [srv1] Lo g 0 from Underfull \hbox (badness 10000) in paragraph at lines 842--847 \T1/txtt/m/n/10 srv12022[]11[]14T01:35:08.041Z [srv2] Log 0 from srv22022[]11[] 14T01:35:09.982Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 849--854 []\T1/txtt/m/n/10 user@host:~$ pebble logs []f 2022[]11[]14T01:37:56.936Z [srv1 ] Log 0 from Underfull \hbox (badness 10000) in paragraph at lines 849--854 \T1/txtt/m/n/10 srv12022[]11[]14T01:37:57.978Z [srv2] Log 0 from srv22022[]11[] 14T01:37:59.939Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 856--861 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]format=json {"time":"2022[]11[]1 4T01:39:10.886Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv1","message":"Log 0 from srv1"}{"time":"2022[]11[ ]14T01:39:11.943Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv2","message":"Log 0 from srv2"}{"time":"2022[]11[ ]14T01:39:13.889Z", Underfull \hbox (badness 10000) in paragraph at lines 863--867 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]verbose 2022[]10[]26T01:41:32.805 Z [pebble] Started daemon. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 2022[]10[]26T01:41:32.835Z [pebble] POST /v1/services 29.743632 ms 2022022[]10[]26T01:41:32. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 835Z [pebble] Started default services with change 7.2022[]10[] 26T01:41:32.849Z [pebble] Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 Service "srv1" starting: python3 []u /path/to/srv1.py2022[]10[] 26T01:41:32.866Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 0 from srv12022[]10[]26T01:41:35.870Z [srv1] Log 1 from srv1202 2[]10[]26T01:41:38.873Z [srv1] [13] Underfull \hbox (badness 10000) in paragraph at lines 878--881 []\T1/txtt/m/n/10 user@host:~$ pebble replan [][]help Usage: pebble replan [rep lan[]OPTIONS] The replan Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 command starts, stops, or restarts services that have changed,s o that running services Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 exactly match the desired configuration in thecurrent plan. [re plan command options] Underfull \hbox (badness 7415) in paragraph at lines 904--909 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:06:50+02:00 INFO S ervice "srv1" already started. Underfull \hbox (badness 7415) in paragraph at lines 911--916 []\T1/txtt/m/n/10 user@host:~$ pebble add lay1 layer.yaml Layer "lay1" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 925--930 []\T1/txtt/m/n/10 user@host:~$ pebble add lay2 layer.yaml Layer "lay2" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 932--935 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:11:22+02:00 INFO S ervice "srv1" already started. [14] Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]help Usage: pebble run [run[]OPTI ONS] The run command starts Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Pebble and runs the configured environment. Additional argument s may be provided to the Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 service command with the [][]args option, whichmust be terminat ed with ";" unless there Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 are no further program options. These argumentsare appended to the end of the service Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 command, and replace any default arguments definedin the servic e plan. For example: Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 pebble run [][]args myservice [][]port 8080 []; [][]hold [run c ommand options] [][]create[]dirs Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Create Pebble directory on startup if it doesn\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 t exist [][]hold Do not start default Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 services automatically [][]http= Start HTTP API listening on th is address (e.g., ":4000") Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 v, [][]verbose Log all output from services to stdout [][]arg s= Provide additional arguments Underfull \hbox (badness 10000) in paragraph at lines 980--983 []\T1/txtt/m/n/10 user@host:~$ pebble run 2022[]10[]26T01:18:26.904Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 2022[]10[]26T01:18:26.921Z [pebble] POST /v1/services 15.53132m s 2022022[]10[]26T01:18:26. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 921Z [pebble] Started default services with change 50.2022[]10[ ]26T01:18:26.936Z [pebble] [15] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 []\T1/txtt/m/n/10 user@host:~$ pebble services [][]help Usage:Usage: pebble ser vices [services[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 [...] The services command lists status information ab out the services Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 specified, orabout all services if none are specified. [service s command options] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 [][]\T1/txtt/m/n/10 abs[]time Display absolute times (in RFC 3339 format). Othe rwise, display relative times Underfull \hbox (badness 10000) in paragraph at lines 1059--1064 []\T1/txtt/m/n/10 user@host:~$ pebble services Service Startup Currentsrv1 enab led activesrv2 disabled [16] Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 []\T1/txtt/m/n/10 user@host:~$ pebble start [][]help Usage: pebble services [se rvices[]OPTIONS] [.. Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 .] The services command lists status information about the serv ices specified, orabout Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 all services if none are specified. [services command options] [][]abs[]time Display Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 absolute times (in RFC 3339 format). Otherwise, display relativ e times up to 60 days, [17] Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 []\T1/txtt/m/n/10 user@host:~$ pebble stop [][]help Usage: pebble stop [stop[]O PTIONS] ... The stop Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 command stops the service with the provided name andany other s ervice that depends on it, Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 in the correct order. [stop command options] [][]no[]wait Do no t wait for the operation to [18] [19] Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 []\T1/txtt/m/n/10 user@host:~$ pebble checks Check Level Status Failures Change up alive up 0/1 10online Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 ready down 1/3 13 (dial tcp 127.0.0.1:8000: connect: connection refused)test [] down Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 42/3 14 (Get "http://localhost:8080/": dial t... run "pebble ta sks 14" for more) \T1/qtm/m/n/10 The [20] [21] [22] [23] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [24] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [25] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [26] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [27] [28] [29] [30] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 []\T1/txtt/m/n/10 user@host:~$ pebble notice [][]help Usage: pebble notice [not ice[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 [] The notice command fetches a single notice, either by I D (1[]arg variant), orby Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 unique type and key combination (2[]arg variant). [notice comma nd options] [][]uid= Look up [31] Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 []\T1/txtt/m/n/10 user@host:~$ pebble notice 1 id: "1"user[]id: 1000type: custo mkey: example.com/ Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 foofirst[]occurred: 2023[]09[]15T04:16:09.179395298Zlast[]occur red: 2023[]09[]15T04:16:19. Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 487035209Zlast[]repeated: 2023[]09[]15T04:16:09.179395298Zoccur rences: 3expire[]after: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 []\T1/txtt/m/n/10 user@host:~$ pebble notice custom other.com/bar id: "2"user[] id: publictype: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 customkey: other.com/barfirst[]occurred: 2023[]09[]15T04:16:17. 180049768Zlast[]occurred: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 2023[]09[]15T04:16:17.180049768Zlast[]repeated: 2023[]09[]15T04 :16:17.180049768Zoccurrences: Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 []\T1/txtt/m/n/10 user@host:~$ pebble notices [][]help Usage: pebble notices [n otices[]OPTIONS] The notices Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 command lists notices not yet acknowledged, ordered by thelast[ ]repeated time (oldest Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 first). After it runs, the notices that were shownmay then be a cknowledged by running Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 pebble okay\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 . When a notice repeats, itneeds to be acknowledged again. [notices command Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 options] [][]abs[]time Display absolute times (in RFC 3339 form at). Otherwise, display Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 relative times up to 60 days, then YYYY[]MM[]DD. [][]users= Sho w all notices with any user ID Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 (admin only; cannot be used with [][]uid) [][]uid= Only list no tices with this user ID (admin Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 only; cannot be used with [][]users) [][]type= Only list notice s of this type (multiple Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 allowed) [][]key= Only list notices with this key (multiple all owed) [][]timeout= Wait up Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 []\T1/txtt/m/n/10 user@host:~$ pebble notices ID User Type Key First Repeated O ccurrences1 1000 custom Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 \T1/txtt/m/n/10 example.com/foo today at 16:16 NZST today at 16:16 NZST 32 publ ic custom other.com/bar [32] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 []\T1/txtt/m/n/10 user@host:~$ pebble notify [][]help Usage: pebble notify [not ify[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 [...] The notify command records a custom notice wi th the specified key and Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 optionaldata fields. [notify command options] [][]repeat[]after = Prevent notice with same Underfull \hbox (badness 10000) in paragraph at lines 2003--2007 []\T1/txtt/m/n/10 user@host:~$ pebble notify other.com/bar name=value email=joh n@smith.com Recorded notice [33] Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]help Usage: pebble exec [exec[]O PTIONS] The exec Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 command runs a remote command and waits for it to finish. The l ocalstdin is sent as the Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 input to the remote process, while the remote stdout andstderr are output locally. To Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 avoid confusion, exec options may be separated from the command and itsarguments using Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 "[][]", for example: pebble exec [][]timeout 10s [][] echo []n foo bar [exec command options] Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 w= Working directory to run command in [][]env= Environment v ariable to set (in \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 FOO=bar\TS1/txtt/m/n/10 ' Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 format) [][]uid= User ID to run command as [][]user= Username t o run command as (user\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 UID must match uid if both present) [][]gid= Group ID to run co mmand as [][]group= Group Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 name to run command as (group\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s GID must match gid if both present) [][]timeout= Timeout Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 after which to terminate command [][]context= Inherit the conte xt of the named service Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 (overridden by []w, [][]env, [][]uid/user, [][]gid/group) []t A llocate remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 and connect stdout to it (default if stdout is a TTY) []T Disab le remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 allocation []i Interactive mode: connect stdin to the pseudo[]t erminal (default if stdin Underfull \hbox (badness 10000) in paragraph at lines 2093--2096 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]timeout 1s [][] sleep 3 error: c annot perform the following [34] Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 []\T1/txtt/m/n/10 user@host:~$ pebble ls [][]help Usage: pebble ls [ls[]OPTIONS ] The ls command lists Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 entries in the filesystem at the specified path. A glob pattern may be specified for Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 the last path element. [ls command options] [][]abs[]time Displ ay absolute times (in RFC Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 3339 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. []d List Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 []\T1/txtt/m/n/10 user@host:~$ pebble mkdir [][]help Usage: pebble mkdir [mkdir []OPTIONS] The mkdir Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 command creates the specified directory. [mkdir command options ] []p Create parent Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 directories as needed []m= Override mode bits (3[]digit octal) [][]uid= Use specified user Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 ID [][]user= Use specified username [][]gid= Use specified grou p ID [][]group= Use specified Underfull \hbox (badness 10000) in paragraph at lines 2147--2151 \T1/txtt/m/n/10 a file or directory. [rm command options] []r Remove all files and directories recursively [35] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 []\T1/txtt/m/n/10 user@host:~$ pebble push [][]help Usage: pebble push [push[]O PTIONS] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 The push command transfers a file to the remote system. [push command Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 options] []p Create parent directories for the file []m= Overri de mode bits (3[]digit octal) Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 [][]\T1/txtt/m/n/10 uid= Use specified user ID [][]user= Use specified username [][]gid= Use specified group ID Underfull \hbox (badness 10000) in paragraph at lines 2177--2180 []\T1/txtt/m/n/10 user@host:~$ pebble pull [][]help Usage: pebble pull The pull (./canonical-pebble.ind) [36] (./canonical-pebble.aux) ) (see the transcript file for additional information){/usr/share/texlive/texmf-d ist/fonts/enc/dvips/base/8r.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/ fontawesome5/fa5free2.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/fontaw esome5/fa5free1.enc}{/usr/share/texmf/fonts/enc/dvips/tex-gyre/q-ts1.enc}{/usr/ share/texmf/fonts/enc/dvips/tex-gyre/q-ec.enc} Output written on canonical-pebble.pdf (40 pages, 258261 bytes). Transcript written on canonical-pebble.log. Latexmk: Index file 'canonical-pebble.idx' was written Latexmk: Log file says output to 'canonical-pebble.pdf' Rule 'pdflatex': File changes, etc: Changed files, or newly in use since previous run(s): 'canonical-pebble.toc' ------------ Run number 3 of rule 'pdflatex' ------------ Latexmk: Examining 'canonical-pebble.log' === TeX engine is 'pdfTeX' Latexmk: applying rule 'pdflatex'... ------------ Running 'pdflatex -interaction=nonstopmode -recorder --jobname="canonical-pebble" "pebble.tex"' ------------ This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2022/dev/Debian) (preloaded format=pdflatex) restricted \write18 enabled. entering extended mode (./pebble.tex LaTeX2e <2021-11-15> patch level 1 L3 programming layer <2022-01-21> (./sphinxmanual.cls Document Class: sphinxmanual 2019/12/01 v2.3.0 Document class (Sphinx manual) (/usr/share/texlive/texmf-dist/tex/latex/base/report.cls Document Class: report 2021/10/04 v1.4n Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size10.clo))) (/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty) (/usr/share/texlive/texmf-dist/tex/latex/cmap/cmap.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty<>) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsmath.sty For additional information on amsmath, use the `?' option. (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amstext.sty (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsgen.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsbsy.sty) (/usr/share/texlive/texmf-dist/tex/latex/amsmath/amsopn.sty)) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amssymb.sty (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/amsfonts.sty)) (/usr/share/texlive/texmf-dist/tex/generic/babel/babel.sty (/usr/share/texlive/texmf-dist/tex/generic/babel/txtbabel.def) (/usr/share/texlive/texmf-dist/tex/generic/babel-english/english.ldf)) (/usr/share/texmf/tex/latex/tex-gyre/tgtermes.sty (/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty) (/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty) (/usr/share/texlive/texmf-dist/tex/generic/kvsetkeys/kvsetkeys.sty))) (/usr/share/texmf/tex/latex/tex-gyre/tgheros.sty) (/usr/share/texlive/texmf-dist/tex/latex/fncychap/fncychap.sty) (./sphinx.sty (/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg) (/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def)) (./sphinxoptionshyperref.sty) (./sphinxoptionsgeometry.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/textcomp.sty) (/usr/share/texlive/texmf-dist/tex/latex/float/float.sty) (/usr/share/texlive/texmf-dist/tex/latex/wrapfig/wrapfig.sty) (/usr/share/texlive/texmf-dist/tex/latex/capt-of/capt-of.sty) (/usr/share/texlive/texmf-dist/tex/latex/tools/multicol.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphicx.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/graphics.sty (/usr/share/texlive/texmf-dist/tex/latex/graphics/trig.sty) (/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/graphics.cfg))) (./sphinxlatexgraphics.sty) (./sphinxpackageboxes.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.sty (/usr/share/texlive/texmf-dist/tex/latex/pict2e/pict2e.cfg) (/usr/share/texlive/texmf-dist/tex/latex/pict2e/p2e-pdftex.def)) (/usr/share/texlive/texmf-dist/tex/latex/ellipse/ellipse.sty)) (./sphinxlatexadmonitions.sty (/usr/share/texlive/texmf-dist/tex/latex/framed/framed.sty)) (./sphinxlatexliterals.sty (/usr/share/texlive/texmf-dist/tex/latex/fancyvrb/fancyvrb.sty) (/usr/share/texlive/texmf-dist/tex/latex/base/alltt.sty) (/usr/share/texlive/texmf-dist/tex/latex/upquote/upquote.sty) (/usr/share/texlive/texmf-dist/tex/latex/needspace/needspace.sty)) (./sphinxlatexshadowbox.sty) (./sphinxlatexcontainers.sty) (./sphinxhighlight.sty) (./sphinxlatextables.sty (/usr/share/texlive/texmf-dist/tex/latex/tabulary/tabulary.sty (/usr/share/texlive/texmf-dist/tex/latex/tools/array.sty)) (/usr/share/texlive/texmf-dist/tex/latex/tools/longtable.sty) (/usr/share/texlive/texmf-dist/tex/latex/varwidth/varwidth.sty) (/usr/share/texlive/texmf-dist/tex/latex/colortbl/colortbl.sty) (/usr/share/texlive/texmf-dist/tex/latex/booktabs/booktabs.sty)) (./sphinxlatexnumfig.sty) (./sphinxlatexlists.sty) (./sphinxpackagefootnote.sty ) (./sphinxlatexindbibtoc.sty (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty)) (./sphinxlatexstylepage.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip.sty (/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip-2001-04-09.sty)) (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty)) (./sphinxlatexstyleheadings.sty (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty)) (./sphinxlatexstyletext.sty) (./sphinxlatexobjects.sty)) (/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/ifvtex.sty (/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty))) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref.sty (/usr/share/texlive/texmf-dist/tex/generic/pdftexcmds/pdftexcmds.sty (/usr/share/texlive/texmf-dist/tex/generic/infwarerr/infwarerr.sty)) (/usr/share/texlive/texmf-dist/tex/generic/kvdefinekeys/kvdefinekeys.sty) (/usr/share/texlive/texmf-dist/tex/generic/pdfescape/pdfescape.sty) (/usr/share/texlive/texmf-dist/tex/latex/hycolor/hycolor.sty) (/usr/share/texlive/texmf-dist/tex/latex/letltxmacro/letltxmacro.sty) (/usr/share/texlive/texmf-dist/tex/latex/auxhook/auxhook.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/pd1enc.def) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hyperref-langpatches.def) (/usr/share/texlive/texmf-dist/tex/generic/intcalc/intcalc.sty) (/usr/share/texlive/texmf-dist/tex/generic/etexcmds/etexcmds.sty) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/puenc.def) (/usr/share/texlive/texmf-dist/tex/latex/url/url.sty) (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty (/usr/share/texlive/texmf-dist/tex/generic/bigintcalc/bigintcalc.sty)) (/usr/share/texlive/texmf-dist/tex/latex/base/atbegshi-ltx.sty)) (/usr/share/texlive/texmf-dist/tex/latex/hyperref/hpdftex.def (/usr/share/texlive/texmf-dist/tex/latex/base/atveryend-ltx.sty) (/usr/share/texlive/texmf-dist/tex/latex/rerunfilecheck/rerunfilecheck.sty (/usr/share/texlive/texmf-dist/tex/generic/uniquecounter/uniquecounter.sty))) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/hypcap.sty) (./sphinxmessages.sty) Writing index file canonical-pebble.idx (/usr/share/texmf/tex/latex/tex-gyre/t1qtm.fd) (/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def) (./canonical-pebble.aux) (/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii [Loading MPS to PDF converter (version 2006.09.02).] ) (/usr/share/texlive/texmf-dist/tex/latex/epstopdf-pkg/epstopdf-base.sty (/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg)) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5.sty (/usr/share/texlive/texmf-dist/tex/latex/l3kernel/expl3.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/l3keys2e/l3keys2e.sty) (/usr/share/texlive/texmf-dist/tex/latex/l3packages/xparse/xparse.sty) (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-generic-help er.sty (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/fontawesome5-mapping.def) )) *geometry* driver: auto-detecting *geometry* detected driver: pdftex (/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty (/usr/share/texlive/texmf-dist/tex/latex/refcount/refcount.sty) (/usr/share/texlive/texmf-dist/tex/generic/gettitlestring/gettitlestring.sty)) (./canonical-pebble.out) (./canonical-pebble.out) (/usr/share/texmf/tex/latex/tex-gyre/t1qhv.fd)<><><><> (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd) (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd) [1{/var/lib/texmf/fo nts/map/pdftex/updmap/pdftex.map}] [2] (./canonical-pebble.toc) [1] [2] [1] [2] Chapter 1. [3] [4] Chapter 2. (/usr/share/texmf/tex/latex/tex-gyre/ts1qtm.fd) (/usr/share/texlive/texmf-dist/tex/latex/txfonts/t1txtt.fd) [5] Underfull \hbox (badness 7415) in paragraph at lines 310--313 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree1.fd) [6] Underfull \hbox (badness 10000) in paragraph at lines 374--379 []\T1/txtt/m/n/10 user@host:~$ pebble run 2024[]06[]02T11:30:02.925Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 2024[]06[]02T11:30:02.936Z [pebble] POST /v1/services 10.751704 ms 2022024[]06[]02T11:30:02. Underfull \hbox (badness 10000) in paragraph at lines 374--379 \T1/txtt/m/n/10 936Z [pebble] Started default services with change 77.2024[]06[ ]02T11:30:02.942Z [pebble] (/usr/share/texlive/texmf-dist/tex/latex/fontawesome5/ufontawesomefree2.fd) Underfull \hbox (badness 10000) in paragraph at lines 418--423 []\T1/txtt/m/n/10 user@host:~$ pebble stop http[]server Service Startup Current Sincehttp[]server enabled [7] Underfull \hbox (badness 7415) in paragraph at lines 470--475 []\T1/txtt/m/n/10 user@host:~$ pebble add layer1 $PEBBLE/layers/002[]another[]h ttp[]server.yaml Layer "layer1" Underfull \hbox (badness 10000) in paragraph at lines 470--475 \T1/txtt/m/n/10 added successfully from "/home/ubuntu/PEBBLE_HOME/layers/002[]a nother[]http[]server.yaml" Underfull \hbox (badness 10000) in paragraph at lines 498--503 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2024[]06[]02T11:40:39Z INFO Servic e "http[]server" already [8] [9] Underfull \hbox (badness 7415) in paragraph at lines 635--640 []\T1/txtt/m/n/10 user@host:~$ pebble Pebble lets you control services and perf orm management actions onthe [10] Underfull \hbox (badness 10000) in paragraph at lines 734--737 []\T1/txtt/m/n/10 user@host:~$ pebble changes [][]help Usage: pebble changes [c hanges[]OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 The changes command displays a summary of system changes perfor med recently. [changes Underfull \hbox (badness 10000) in paragraph at lines 734--737 \T1/txtt/m/n/10 command options] [][]abs[]time Display absolute times (in RFC 3 339 format). Otherwise, [11] Underfull \hbox (badness 10000) in paragraph at lines 766--769 []\T1/txtt/m/n/10 user@host:~$ pebble tasks [][]help Usage: pebble tasks [tasks []OPTIONS] [] Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 The tasks command displays a summary of tasks associated with a n individualchange that Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 happened recently. [tasks command options] [][]abs[]time Displa y absolute times (in RFC 3339 Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. [][]last= Select Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 last change of given type (install, refresh, remove, try, auto[ ]refresh, etc.). A question Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 mark at the end of the type means to do nothing (instead of ret urning an error) if no Underfull \hbox (badness 10000) in paragraph at lines 766--769 \T1/txtt/m/n/10 change of the given type is found. Note the question mark could need protecting from the Underfull \hbox (badness 10000) in paragraph at lines 776--780 []\T1/txtt/m/n/10 user@host:~$ pebble tasks 3 Status Spawn Ready SummaryDone to day at 15:26 NZDT today at Underfull \hbox (badness 10000) in paragraph at lines 776--780 \T1/txtt/m/n/10 15:26 NZDT Stop service "srv1"Done today at 15:26 NZDT today at 15:26 NZDT Stop service [12] (/usr/share/texlive/texmf-dist/tex/latex/txfonts/ts1txtt.fd) Underfull \hbox (badness 10000) in paragraph at lines 832--835 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]help Usage: pebble logs [logs[]O PTIONS] [...] The Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 logs command fetches buffered logs from the given services (or all servicesif none Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified) and displays them in chronological order. [logs command options] []f, Underfull \hbox (badness 10000) in paragraph at lines 832--835 [][]\T1/txtt/m/n/10 follow Follow (tail) logs for given services until Ctrl[]C is pressed. If no services Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 are specified, show logs from all services running when the com mand starts. [][]format= Underfull \hbox (badness 10000) in paragraph at lines 832--835 \T1/txtt/m/n/10 Output format: "text" (default) or "json" (JSON lines). []n= Nu mber of logs to show Underfull \hbox (badness 10000) in paragraph at lines 842--847 []\T1/txtt/m/n/10 user@host:~$ pebble logs 2022[]11[]14T01:35:06.979Z [srv1] Lo g 0 from Underfull \hbox (badness 10000) in paragraph at lines 842--847 \T1/txtt/m/n/10 srv12022[]11[]14T01:35:08.041Z [srv2] Log 0 from srv22022[]11[] 14T01:35:09.982Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 849--854 []\T1/txtt/m/n/10 user@host:~$ pebble logs []f 2022[]11[]14T01:37:56.936Z [srv1 ] Log 0 from Underfull \hbox (badness 10000) in paragraph at lines 849--854 \T1/txtt/m/n/10 srv12022[]11[]14T01:37:57.978Z [srv2] Log 0 from srv22022[]11[] 14T01:37:59.939Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 856--861 []\T1/txtt/m/n/10 user@host:~$ pebble logs [][]format=json {"time":"2022[]11[]1 4T01:39:10.886Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv1","message":"Log 0 from srv1"}{"time":"2022[]11[ ]14T01:39:11.943Z", Underfull \hbox (badness 10000) in paragraph at lines 856--861 \T1/txtt/m/n/10 "service":"srv2","message":"Log 0 from srv2"}{"time":"2022[]11[ ]14T01:39:13.889Z", Underfull \hbox (badness 10000) in paragraph at lines 863--867 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]verbose 2022[]10[]26T01:41:32.805 Z [pebble] Started daemon. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 2022[]10[]26T01:41:32.835Z [pebble] POST /v1/services 29.743632 ms 2022022[]10[]26T01:41:32. Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 835Z [pebble] Started default services with change 7.2022[]10[] 26T01:41:32.849Z [pebble] Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 Service "srv1" starting: python3 []u /path/to/srv1.py2022[]10[] 26T01:41:32.866Z [srv1] Log Underfull \hbox (badness 10000) in paragraph at lines 863--867 \T1/txtt/m/n/10 0 from srv12022[]10[]26T01:41:35.870Z [srv1] Log 1 from srv1202 2[]10[]26T01:41:38.873Z [srv1] [13] Underfull \hbox (badness 10000) in paragraph at lines 878--881 []\T1/txtt/m/n/10 user@host:~$ pebble replan [][]help Usage: pebble replan [rep lan[]OPTIONS] The replan Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 command starts, stops, or restarts services that have changed,s o that running services Underfull \hbox (badness 10000) in paragraph at lines 878--881 \T1/txtt/m/n/10 exactly match the desired configuration in thecurrent plan. [re plan command options] Underfull \hbox (badness 7415) in paragraph at lines 904--909 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:06:50+02:00 INFO S ervice "srv1" already started. Underfull \hbox (badness 7415) in paragraph at lines 911--916 []\T1/txtt/m/n/10 user@host:~$ pebble add lay1 layer.yaml Layer "lay1" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 925--930 []\T1/txtt/m/n/10 user@host:~$ pebble add lay2 layer.yaml Layer "lay2" added su ccessfully from "layer.yaml" Underfull \hbox (badness 7415) in paragraph at lines 932--935 []\T1/txtt/m/n/10 user@host:~$ pebble replan 2023[]04[]25T15:11:22+02:00 INFO S ervice "srv1" already started. [14] Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 user@host:~$ pebble run [][]help Usage: pebble run [run[]OPTI ONS] The run command starts Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Pebble and runs the configured environment. Additional argument s may be provided to the Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 service command with the [][]args option, whichmust be terminat ed with ";" unless there Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 are no further program options. These argumentsare appended to the end of the service Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 command, and replace any default arguments definedin the servic e plan. For example: Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 pebble run [][]args myservice [][]port 8080 []; [][]hold [run c ommand options] [][]create[]dirs Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 Create Pebble directory on startup if it doesn\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 t exist [][]hold Do not start default Underfull \hbox (badness 10000) in paragraph at lines 952--955 \T1/txtt/m/n/10 services automatically [][]http= Start HTTP API listening on th is address (e.g., ":4000") Underfull \hbox (badness 10000) in paragraph at lines 952--955 []\T1/txtt/m/n/10 v, [][]verbose Log all output from services to stdout [][]arg s= Provide additional arguments Underfull \hbox (badness 10000) in paragraph at lines 980--983 []\T1/txtt/m/n/10 user@host:~$ pebble run 2022[]10[]26T01:18:26.904Z [pebble] S tarted daemon. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 2022[]10[]26T01:18:26.921Z [pebble] POST /v1/services 15.53132m s 2022022[]10[]26T01:18:26. Underfull \hbox (badness 10000) in paragraph at lines 980--983 \T1/txtt/m/n/10 921Z [pebble] Started default services with change 50.2022[]10[ ]26T01:18:26.936Z [pebble] [15] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 []\T1/txtt/m/n/10 user@host:~$ pebble services [][]help Usage:Usage: pebble ser vices [services[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 [...] The services command lists status information ab out the services Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 \T1/txtt/m/n/10 specified, orabout all services if none are specified. [service s command options] Underfull \hbox (badness 10000) in paragraph at lines 1039--1042 [][]\T1/txtt/m/n/10 abs[]time Display absolute times (in RFC 3339 format). Othe rwise, display relative times Underfull \hbox (badness 10000) in paragraph at lines 1059--1064 []\T1/txtt/m/n/10 user@host:~$ pebble services Service Startup Currentsrv1 enab led activesrv2 disabled [16] Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 []\T1/txtt/m/n/10 user@host:~$ pebble start [][]help Usage: pebble services [se rvices[]OPTIONS] [.. Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 .] The services command lists status information about the serv ices specified, orabout Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 all services if none are specified. [services command options] [][]abs[]time Display Underfull \hbox (badness 10000) in paragraph at lines 1098--1101 \T1/txtt/m/n/10 absolute times (in RFC 3339 format). Otherwise, display relativ e times up to 60 days, [17] Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 []\T1/txtt/m/n/10 user@host:~$ pebble stop [][]help Usage: pebble stop [stop[]O PTIONS] ... The stop Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 command stops the service with the provided name andany other s ervice that depends on it, Underfull \hbox (badness 10000) in paragraph at lines 1129--1132 \T1/txtt/m/n/10 in the correct order. [stop command options] [][]no[]wait Do no t wait for the operation to [18] [19] Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 []\T1/txtt/m/n/10 user@host:~$ pebble checks Check Level Status Failures Change up alive up 0/1 10online Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 ready down 1/3 13 (dial tcp 127.0.0.1:8000: connect: connection refused)test [] down Underfull \hbox (badness 10000) in paragraph at lines 1292--1297 \T1/txtt/m/n/10 42/3 14 (Get "http://localhost:8080/": dial t... run "pebble ta sks 14" for more) \T1/qtm/m/n/10 The [20] [21] [22] [23] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [24] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [25] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [26] Underfull \vbox (badness 10000) detected at line 1697 Underfull \vbox (badness 10000) detected at line 1697 [27] [28] [29] [30] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 []\T1/txtt/m/n/10 user@host:~$ pebble notice [][]help Usage: pebble notice [not ice[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 [] The notice command fetches a single notice, either by I D (1[]arg variant), orby Underfull \hbox (badness 10000) in paragraph at lines 1929--1932 \T1/txtt/m/n/10 unique type and key combination (2[]arg variant). [notice comma nd options] [][]uid= Look up [31] Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 []\T1/txtt/m/n/10 user@host:~$ pebble notice 1 id: "1"user[]id: 1000type: custo mkey: example.com/ Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 foofirst[]occurred: 2023[]09[]15T04:16:09.179395298Zlast[]occur red: 2023[]09[]15T04:16:19. Underfull \hbox (badness 10000) in paragraph at lines 1939--1944 \T1/txtt/m/n/10 487035209Zlast[]repeated: 2023[]09[]15T04:16:09.179395298Zoccur rences: 3expire[]after: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 []\T1/txtt/m/n/10 user@host:~$ pebble notice custom other.com/bar id: "2"user[] id: publictype: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 customkey: other.com/barfirst[]occurred: 2023[]09[]15T04:16:17. 180049768Zlast[]occurred: Underfull \hbox (badness 10000) in paragraph at lines 1946--1950 \T1/txtt/m/n/10 2023[]09[]15T04:16:17.180049768Zlast[]repeated: 2023[]09[]15T04 :16:17.180049768Zoccurrences: Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 []\T1/txtt/m/n/10 user@host:~$ pebble notices [][]help Usage: pebble notices [n otices[]OPTIONS] The notices Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 command lists notices not yet acknowledged, ordered by thelast[ ]repeated time (oldest Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 first). After it runs, the notices that were shownmay then be a cknowledged by running Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 pebble okay\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 . When a notice repeats, itneeds to be acknowledged again. [notices command Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 options] [][]abs[]time Display absolute times (in RFC 3339 form at). Otherwise, display Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 relative times up to 60 days, then YYYY[]MM[]DD. [][]users= Sho w all notices with any user ID Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 (admin only; cannot be used with [][]uid) [][]uid= Only list no tices with this user ID (admin Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 only; cannot be used with [][]users) [][]type= Only list notice s of this type (multiple Underfull \hbox (badness 10000) in paragraph at lines 1961--1964 \T1/txtt/m/n/10 allowed) [][]key= Only list notices with this key (multiple all owed) [][]timeout= Wait up Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 []\T1/txtt/m/n/10 user@host:~$ pebble notices ID User Type Key First Repeated O ccurrences1 1000 custom Underfull \hbox (badness 10000) in paragraph at lines 1971--1975 \T1/txtt/m/n/10 example.com/foo today at 16:16 NZST today at 16:16 NZST 32 publ ic custom other.com/bar [32] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 []\T1/txtt/m/n/10 user@host:~$ pebble notify [][]help Usage: pebble notify [not ify[]OPTIONS] Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 [...] The notify command records a custom notice wi th the specified key and Underfull \hbox (badness 10000) in paragraph at lines 1986--1989 \T1/txtt/m/n/10 optionaldata fields. [notify command options] [][]repeat[]after = Prevent notice with same Underfull \hbox (badness 10000) in paragraph at lines 2003--2007 []\T1/txtt/m/n/10 user@host:~$ pebble notify other.com/bar name=value email=joh n@smith.com Recorded notice [33] Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]help Usage: pebble exec [exec[]O PTIONS] The exec Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 command runs a remote command and waits for it to finish. The l ocalstdin is sent as the Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 input to the remote process, while the remote stdout andstderr are output locally. To Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 avoid confusion, exec options may be separated from the command and itsarguments using Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 "[][]", for example: pebble exec [][]timeout 10s [][] echo []n foo bar [exec command options] Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 []\T1/txtt/m/n/10 w= Working directory to run command in [][]env= Environment v ariable to set (in \TS1/txtt/m/n/10 '\T1/txtt/m/n/10 FOO=bar\TS1/txtt/m/n/10 ' Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 format) [][]uid= User ID to run command as [][]user= Username t o run command as (user\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 UID must match uid if both present) [][]gid= Group ID to run co mmand as [][]group= Group Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 name to run command as (group\TS1/txtt/m/n/10 '\T1/txtt/m/n/10 s GID must match gid if both present) [][]timeout= Timeout Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 after which to terminate command [][]context= Inherit the conte xt of the named service Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 (overridden by []w, [][]env, [][]uid/user, [][]gid/group) []t A llocate remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 and connect stdout to it (default if stdout is a TTY) []T Disab le remote pseudo[]terminal Underfull \hbox (badness 10000) in paragraph at lines 2073--2076 \T1/txtt/m/n/10 allocation []i Interactive mode: connect stdin to the pseudo[]t erminal (default if stdin Underfull \hbox (badness 10000) in paragraph at lines 2093--2096 []\T1/txtt/m/n/10 user@host:~$ pebble exec [][]timeout 1s [][] sleep 3 error: c annot perform the following [34] Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 []\T1/txtt/m/n/10 user@host:~$ pebble ls [][]help Usage: pebble ls [ls[]OPTIONS ] The ls command lists Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 entries in the filesystem at the specified path. A glob pattern may be specified for Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 the last path element. [ls command options] [][]abs[]time Displ ay absolute times (in RFC Underfull \hbox (badness 10000) in paragraph at lines 2117--2121 \T1/txtt/m/n/10 3339 format). Otherwise, display relative times up to 60 days, then YYYY[]MM[]DD. []d List Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 []\T1/txtt/m/n/10 user@host:~$ pebble mkdir [][]help Usage: pebble mkdir [mkdir []OPTIONS] The mkdir Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 command creates the specified directory. [mkdir command options ] []p Create parent Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 directories as needed []m= Override mode bits (3[]digit octal) [][]uid= Use specified user Underfull \hbox (badness 10000) in paragraph at lines 2132--2136 \T1/txtt/m/n/10 ID [][]user= Use specified username [][]gid= Use specified grou p ID [][]group= Use specified Underfull \hbox (badness 10000) in paragraph at lines 2147--2151 \T1/txtt/m/n/10 a file or directory. [rm command options] []r Remove all files and directories recursively [35] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 []\T1/txtt/m/n/10 user@host:~$ pebble push [][]help Usage: pebble push [push[]O PTIONS] Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 The push command transfers a file to the remote system. [push command Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 \T1/txtt/m/n/10 options] []p Create parent directories for the file []m= Overri de mode bits (3[]digit octal) Underfull \hbox (badness 10000) in paragraph at lines 2162--2166 [][]\T1/txtt/m/n/10 uid= Use specified user ID [][]user= Use specified username [][]gid= Use specified group ID Underfull \hbox (badness 10000) in paragraph at lines 2177--2180 []\T1/txtt/m/n/10 user@host:~$ pebble pull [][]help Usage: pebble pull The pull (./canonical-pebble.ind) [36] (./canonical-pebble.aux) ) (see the transcript file for additional information){/usr/share/texlive/texmf-d ist/fonts/enc/dvips/base/8r.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/ fontawesome5/fa5free2.enc}{/usr/share/texlive/texmf-dist/fonts/enc/dvips/fontaw esome5/fa5free1.enc}{/usr/share/texmf/fonts/enc/dvips/tex-gyre/q-ts1.enc}{/usr/ share/texmf/fonts/enc/dvips/tex-gyre/q-ec.enc} Output written on canonical-pebble.pdf (40 pages, 258261 bytes). Transcript written on canonical-pebble.log. Latexmk: Index file 'canonical-pebble.idx' was written Latexmk: Log file says output to 'canonical-pebble.pdf' Latexmk: Examining 'canonical-pebble.log' === TeX engine is 'pdfTeX' Latexmk: All targets (canonical-pebble.pdf) are up-to-date