{
    "content": [
        {
            "type": "text",
            "text": "# dbus-update-activation-environment (man)\n\n## NAME\n\ndbus-update-activation-environment - update environment used for D-Bus session services\n\n## SYNOPSIS\n\ndbus-update-activation-environment [--systemd] [--verbose] --all | VAR... | VAR=VAL...\n\n## DESCRIPTION\n\ndbus-update-activation-environment updates the list of environment variables used by\ndbus-daemon --session when it activates session services without using systemd.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (3 subsections)\n- **EXAMPLES**\n- **EXIT STATUS**\n- **ENVIRONMENT**\n- **LIMITATIONS**\n- **BUGS**\n- **SEE ALSO**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "dbus-update-activation-environment",
        "section": "",
        "mode": "man",
        "summary": "dbus-update-activation-environment - update environment used for D-Bus session services",
        "synopsis": "dbus-update-activation-environment [--systemd] [--verbose] --all | VAR... | VAR=VAL...",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "",
                "long": "--all",
                "arg": null,
                "description": "Set all environment variables present in the environment used by dbus-update-activation-environment."
            },
            {
                "flag": "",
                "long": "--systemd",
                "arg": null,
                "description": "Set environment variables for systemd user services as well as for traditional D-Bus session services."
            },
            {
                "flag": "",
                "long": "--verbose",
                "arg": null,
                "description": "Output messages to standard error explaining what dbus-update-activation-environment is doing. VAR If VAR is present in the environment of dbus-update-activation-environment, set it to the same value for D-Bus services. Its value must be UTF-8 (if not, it is skipped with a warning). If VAR is not present in the environment, this argument is silently ignored. VAR=VAL Set VAR to VAL, which must be UTF-8."
            }
        ],
        "examples": [
            "dbus-update-activation-environment is primarily designed to be used in Linux distributions'",
            "X11 session startup scripts, in conjunction with the \"user bus\" design.",
            "To propagate DISPLAY and XAUTHORITY to dbus-daemon and, if present, systemd, and propagate",
            "DBUSSESSIONBUSADDRESS to systemd:",
            "dbus-update-activation-environment --systemd \\",
            "DBUSSESSIONBUSADDRESS DISPLAY XAUTHORITY",
            "To propagate all environment variables except XDGSEAT, XDGSESSIONID and XDGVTNR to",
            "dbus-daemon (and, if present, systemd) for compatibility with legacy X11 session startup",
            "scripts:",
            "# in a subshell so the variables remain set in the",
            "# parent script",
            "unset XDGSEAT",
            "unset XDGSESSIONID",
            "unset XDGVTNR",
            "dbus-update-activation-environment --systemd --all"
        ],
        "see_also": [
            {
                "name": "dbus-daemon",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/dbus-daemon/1/json"
            },
            {
                "name": "systemd",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/systemd/1/json"
            },
            {
                "name": "systemctl",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/systemctl/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 14,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "--all",
                        "lines": 3,
                        "long": "--all"
                    },
                    {
                        "name": "--systemd",
                        "lines": 3,
                        "long": "--systemd"
                    },
                    {
                        "name": "--verbose",
                        "lines": 11,
                        "long": "--verbose"
                    }
                ]
            },
            {
                "name": "EXAMPLES",
                "lines": 26,
                "subsections": []
            },
            {
                "name": "EXIT STATUS",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "ENVIRONMENT",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "LIMITATIONS",
                "lines": 10,
                "subsections": []
            },
            {
                "name": "BUGS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 9,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "dbus-update-activation-environment - update environment used for D-Bus session services\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "dbus-update-activation-environment [--systemd] [--verbose] --all | VAR... | VAR=VAL...\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "dbus-update-activation-environment updates the list of environment variables used by\ndbus-daemon --session when it activates session services without using systemd.\n\nWith the --systemd option, if an instance of systemd --user is available on D-Bus, it also\nupdates the list of environment variables used by systemd --user when it activates user\nservices, including D-Bus session services for which dbus-daemon has been configured to\ndelegate activation to systemd. This is very similar to the import-environment command\nprovided by systemctl(1)).\n\nVariables that are special to dbus-daemon or systemd may be set, but their values will be\noverridden when a service is started. For instance, it is not useful to add\nDBUSSESSIONBUSADDRESS to dbus-daemon's activation environment, although it might still be\nuseful to add it to systemd's activation environment.\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "",
                "subsections": [
                    {
                        "name": "--all",
                        "content": "Set all environment variables present in the environment used by\ndbus-update-activation-environment.\n",
                        "long": "--all"
                    },
                    {
                        "name": "--systemd",
                        "content": "Set environment variables for systemd user services as well as for traditional D-Bus\nsession services.\n",
                        "long": "--systemd"
                    },
                    {
                        "name": "--verbose",
                        "content": "Output messages to standard error explaining what dbus-update-activation-environment is\ndoing.\n\nVAR\nIf VAR is present in the environment of dbus-update-activation-environment, set it to the\nsame value for D-Bus services. Its value must be UTF-8 (if not, it is skipped with a\nwarning). If VAR is not present in the environment, this argument is silently ignored.\n\nVAR=VAL\nSet VAR to VAL, which must be UTF-8.\n",
                        "long": "--verbose"
                    }
                ]
            },
            "EXAMPLES": {
                "content": "dbus-update-activation-environment is primarily designed to be used in Linux distributions'\nX11 session startup scripts, in conjunction with the \"user bus\" design.\n\nTo propagate DISPLAY and XAUTHORITY to dbus-daemon and, if present, systemd, and propagate\nDBUSSESSIONBUSADDRESS to systemd:\n\ndbus-update-activation-environment --systemd \\\nDBUSSESSIONBUSADDRESS DISPLAY XAUTHORITY\n\n\nTo propagate all environment variables except XDGSEAT, XDGSESSIONID and XDGVTNR to\ndbus-daemon (and, if present, systemd) for compatibility with legacy X11 session startup\nscripts:\n\n# in a subshell so the variables remain set in the\n# parent script\n(\nunset XDGSEAT\nunset XDGSESSIONID\nunset XDGVTNR\n\ndbus-update-activation-environment --systemd --all\n)\n\n\n",
                "subsections": []
            },
            "EXIT STATUS": {
                "content": "dbus-update-activation-environment exits with status 0 on success, EXUSAGE (64) on invalid\ncommand-line options, EXOSERR (71) if unable to connect to the session bus, or\nEXUNAVAILABLE (69) if unable to set the environment variables. Other nonzero exit codes\nmight be added in future versions.\n",
                "subsections": []
            },
            "ENVIRONMENT": {
                "content": "DBUSSESSIONBUSADDRESS, XDGRUNTIMEDIR and/or DISPLAY are used to find the address of the\nsession bus.\n",
                "subsections": []
            },
            "LIMITATIONS": {
                "content": "dbus-daemon does not provide a way to unset environment variables after they have been set\n(although systemd does), so dbus-update-activation-environment does not offer this\nfunctionality either.\n\nPOSIX does not specify the encoding of non-ASCII environment variable names or values and\nallows them to contain any non-zero byte, but neither dbus-daemon nor systemd supports\nenvironment variables with non-UTF-8 names or values. Accordingly,\ndbus-update-activation-environment assumes that any name or value that appears to be valid\nUTF-8 is intended to be UTF-8, and ignores other names or values with a warning.\n",
                "subsections": []
            },
            "BUGS": {
                "content": "Please send bug reports to the D-Bus bug tracker or mailing list. See\nhttp://www.freedesktop.org/software/dbus/.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "dbus-daemon(1), systemd(1), the import-environment command of systemctl(1)\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright © 2015 Collabora Ltd.\n\nThis man page is distributed under the same terms as dbus-update-activation-environment\n(MIT/X11). There is NO WARRANTY, to the extent permitted by law.\n\n\n\n\nD-Bus 1.12.20                                                                  DBUS-UPDATE-ACTIVA(1)",
                "subsections": []
            }
        }
    }
}