--- /srv/reproducible-results/rbuild-debian/r-b-build.asdqNC2q/b1/x2goserver_4.1.0.6-1.1_i386.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.asdqNC2q/b2/x2goserver_4.1.0.6-1.1_i386.changes ├── Files │ @@ -9,8 +9,8 @@ │ 34960f11abe4aa3260712270da3e9abd 65280 x11 optional x2goserver-desktopsharing_4.1.0.6-1.1_all.deb │ 1ef490c58d56ebaaabbddd33f3b96625 57804 x11 optional x2goserver-extensions_4.1.0.6-1.1_all.deb │ 3e4a3cdc7feaf5b91968be7bfc88a297 54284 x11 optional x2goserver-fmbindings_4.1.0.6-1.1_all.deb │ bd14f329d7117695f3a983a6ac4678ed 59152 x11 optional x2goserver-printing_4.1.0.6-1.1_all.deb │ c5643c937b7edac851f162e7f39d0629 56800 x11 optional x2goserver-x2goagent_4.1.0.6-1.1_i386.deb │ e740ea5b51f86eaefcb213bb73eb7edf 53704 x11 optional x2goserver-x2gokdrive_4.1.0.6-1.1_i386.deb │ b86abee1c95164abf5bd38f3e86fa04d 56836 x11 optional x2goserver-xsession_4.1.0.6-1.1_all.deb │ - aee1fac3731b05ae913ce163369f3f50 138700 x11 optional x2goserver_4.1.0.6-1.1_i386.deb │ + d651f52e051221a0d1001ce41f5396b1 137872 x11 optional x2goserver_4.1.0.6-1.1_i386.deb ├── x2goserver_4.1.0.6-1.1_i386.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-09-23 14:10:47.000000 debian-binary │ │ --rw-r--r-- 0 0 0 9456 2023-09-23 14:10:47.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 129052 2023-09-23 14:10:47.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 9452 2023-09-23 14:10:47.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 128228 2023-09-23 14:10:47.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,12 +1,12 @@ │ │ │ │ Package: x2goserver │ │ │ │ Version: 4.1.0.6-1.1 │ │ │ │ Architecture: i386 │ │ │ │ Maintainer: Debian Remote Maintainers │ │ │ │ -Installed-Size: 527 │ │ │ │ +Installed-Size: 517 │ │ │ │ Pre-Depends: init-system-helpers (>= 1.54~) │ │ │ │ Depends: bc, libfile-basedir-perl, libfile-which-perl, libswitch-perl, libtry-tiny-perl, libx2go-server-perl (<< 4.1.0.6-1.1.1~), libx2go-server-perl (>= 4.1.0.6-1.1), lsof, net-tools, openssh-client, openssh-server, perl, psmisc, pwgen, x2goserver-common (<< 4.1.0.6-1.1.1~), x2goserver-common (>= 4.1.0.6-1.1), x2goserver-x2goagent (<< 4.1.0.6-1.1.1~), x2goserver-x2goagent (>= 4.1.0.6-1.1), xauth, xkb-data, debconf (>= 0.5) | debconf-2.0 │ │ │ │ Recommends: fontconfig, sshfs, x11-apps, x11-session-utils, x11-utils, x11-xfs-utils, x11-xkb-utils, x11-xserver-utils, x2goserver-extensions (<< 4.1.0.6-1.1.1~), x2goserver-extensions (>= 4.1.0.6-1.1), x2goserver-fmbindings (<< 4.1.0.6-1.1.1~), x2goserver-fmbindings (>= 4.1.0.6-1.1), x2goserver-printing (<< 4.1.0.6-1.1.1~), x2goserver-printing (>= 4.1.0.6-1.1), x2goserver-xsession (<< 4.1.0.6-1.1.1~), x2goserver-xsession (>= 4.1.0.6-1.1), xfonts-base, xinit │ │ │ │ Suggests: pulseaudio-utils, rdesktop │ │ │ │ Breaks: x2godesktopsharing (<< 3.1.1.2-0~), x2goserver-compat (<< 4.0.1.99~), x2goserver-home, x2goserver-one, x2goserver-pyhoca (<< 4.0.1.99~) │ │ │ │ Replaces: x2goserver-compat, x2goserver-home, x2goserver-one, x2goserver-pyhoca │ │ │ │ Section: x11 │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -76,15 +76,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 696 2023-08-18 02:36:33.000000 ./usr/share/doc/x2goserver/README.sudoers │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1110 2023-08-18 02:36:33.000000 ./usr/share/doc/x2goserver/README.upgrade-pgsql-database │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1849 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/changelog.Debian.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 46044 2023-08-18 02:36:33.000000 ./usr/share/doc/x2goserver/changelog.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 11661 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/copyright │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man1/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 10281 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man1/x2gooptionsstring.1.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 311 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man1/x2gooptionsstring.1.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man5/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4117 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man5/x2goserver.conf.5.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man8/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1346 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man8/x2gobasepath.8.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2109 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man8/x2gocleansessions.8.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1657 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man8/x2gocmdexitmessage.8.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1391 2023-09-23 14:10:47.000000 ./usr/share/doc/x2goserver/html/man8/x2godbadmin.8.html │ │ │ ├── ./usr/share/doc/x2goserver/html/man1/x2gooptionsstring.1.html │ │ │ │ @@ -1,526 +1,8 @@ │ │ │ │ +Status: 403 Forbidden │ │ │ │ Content-type: text/html; charset=UTF-8 │ │ │ │ │ │ │ │ │ │ │ │ -Man page of X2GOOPTIONSSTRING │ │ │ │ - │ │ │ │ -

X2GOOPTIONSSTRING

│ │ │ │ -Section: General Commands Manual (1)
Updated: 2023-09-23
Index │ │ │ │ -Return to Main Contents
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -  │ │ │ │ -

NAME

│ │ │ │ - │ │ │ │ -x2gooptionsstring - X2Go Agent Options String Manipulator and Extractor │ │ │ │ -  │ │ │ │ -

SYNOPSIS

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ -
x2gooptionsstring --help|-h|-?
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -
x2gooptionsstring --man
│ │ │ │ - │ │ │ │ - │ │ │ │ -
x2gooptionsstring [<--mode|-m><=| >t[ransform]|-t] [--compact|-c] [--base64|-b] [--debug|-d] [--] options_string [+]|-key[=value] ...
│ │ │ │ - │ │ │ │ - │ │ │ │ -
x2gooptionsstring <--mode|-m><=| >e[xtract]|-e [--base64|-b] [--debug|-d] [--] options_string key[=value] ...
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ -  │ │ │ │ -

DESCRIPTION

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -x2gooptionsstring is a utility for manipulating and extracting data from │ │ │ │ -options strings as passed to X2Go/NX Agent. │ │ │ │ -For more information about supported options strings, refer to the OPTIONS │ │ │ │ -STRINGS section in the X2Go::Server::Agent::NX::Options │ │ │ │ -documentation. │ │ │ │ -

│ │ │ │ - │ │ │ │ -For full support of options string, which are allowed (but not recommended) to │ │ │ │ -include binary data, the special --base64|-b switch is supported. │ │ │ │ -If given, all arguments other than flags must be base64-encoded (making it │ │ │ │ -possible to pass binary data via shells, for instance). │ │ │ │ -The program's output, minus potentially debugging messages, will also be │ │ │ │ -base64-encoded. │ │ │ │ -

│ │ │ │ - │ │ │ │ -Currently, two modes are supported: │ │ │ │ -

│ │ │ │ -
Transform (default)
│ │ │ │ - │ │ │ │ - │ │ │ │ -Transformation mode is enabled by default if no mode has been explicitly │ │ │ │ -selected. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Call this program with optional flags, the options string as the first │ │ │ │ -parameter and the transformations to be carried out as additional parameters. │ │ │ │ -At least one additional parameter (i.e., a transformation) must be provided. │ │ │ │ -Transformations are described here briefly, but also in the TRANSFORMATIONS │ │ │ │ -section in the X2Go::Server::Agent::NX::Options │ │ │ │ -documentation. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -It can either add, remove or replace components. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -To add or replace a component, pass key[=value] or │ │ │ │ -+key[=value] as a parameter. │ │ │ │ -The latter syntax is useful if key starts with a dash and would therefore │ │ │ │ -be interpreted as a removal operation. │ │ │ │ -If the options string does not include a key key, it will be appended to │ │ │ │ -the end of the options string. │ │ │ │ -If it already exists, either with no value or a different value, the component │ │ │ │ -will be replaced with the provided value. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -To fully remove a component, pass -key. │ │ │ │ -To only remove it if it is set to a specific value, pass │ │ │ │ --key=value. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Use the --compact option to minimize the original options string, removing │ │ │ │ -duplicated and empty entries. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Assuming no error happened, the resulting options string is written to │ │ │ │ -stdout. │ │ │ │ -

Extract
│ │ │ │ - │ │ │ │ - │ │ │ │ -Extraction mode must be explicitly requested using the -e or │ │ │ │ -<--mode|-m><=| >e[xtract] flags. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Call this program with optional flags, the options string as the first │ │ │ │ -parameter and key-value pairs to be extracted as additional parameters. │ │ │ │ -At least one additional parameter (i.e., a key-value pair to extract) must be │ │ │ │ -provided. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -A degenerated key-value pair without an explicit value can be used to test for │ │ │ │ -the existence of a key and extract its value at the same time. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -A full, proper key-value pair can be used to test for the existence of a │ │ │ │ -key-value pair exactly as provided. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Assuming no error happened, the extracted key-value pairs will be written to │ │ │ │ -stdout. │ │ │ │ -Each pair will be base64-encoded and, if multiple key-value pairs to extract │ │ │ │ -have been provided, delimited via pipe characters ("|"). │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Key-value pairs which haven't been found in the original options string, as │ │ │ │ -well as potentially an empty key-value pair, will be represented as empty │ │ │ │ -fields. │ │ │ │ -

│ │ │ │ -

│ │ │ │ - │ │ │ │ -Refer to the OPTIONS PARSING section for a description of │ │ │ │ -when and how to terminate options passed to this program. │ │ │ │ -  │ │ │ │ -

OPTIONS

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ -
--help|-?|-h
│ │ │ │ - │ │ │ │ - │ │ │ │ -Print a brief help message and exits. │ │ │ │ -
--man
│ │ │ │ - │ │ │ │ - │ │ │ │ -Prints the manual page and exits. │ │ │ │ -
--debug|-d
│ │ │ │ - │ │ │ │ - │ │ │ │ -Enables noisy debug output. │ │ │ │ -
-t
│ │ │ │ - │ │ │ │ - │ │ │ │ -Shorthand for --mode=transform. │ │ │ │ -
-e
│ │ │ │ - │ │ │ │ - │ │ │ │ -Shorthand for --mode=extract. │ │ │ │ -
<--mode|-m><=| >mode string
│ │ │ │ - │ │ │ │ - │ │ │ │ -Selects a specific program mode. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Currently, the following mode strings are supported: │ │ │ │ -

│ │ │ │ -
│ │ │ │ -
•
│ │ │ │ -transform │ │ │ │ -
•
│ │ │ │ -extract │ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Mode strings can be abbreviated, as long as the abbreviation is uniquely │ │ │ │ -selecting one mode exactly. │ │ │ │ -

│ │ │ │ - │ │ │ │ -
--compact|-c
│ │ │ │ - │ │ │ │ - │ │ │ │ -Remove duplicate and empty entries after the initial parsing. │ │ │ │ -The order of arguments is preserved in a first-seen fashion. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -This option is only available in transformation mode. │ │ │ │ -It will be silently ignored in extraction mode, as compaction is a │ │ │ │ -pre-requisite and done automatically during extraction. │ │ │ │ -

--base64|-b
│ │ │ │ - │ │ │ │ - │ │ │ │ -Enable a special full base64 mode. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Any binary data can be given and output by this program in this mode, even │ │ │ │ -when operating on a shell. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Input parameters must always be provided encoded in base64 form. │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Likewise, the program will always output data encoded in a base64 form. │ │ │ │ -Since key-value pairs returned in extraction mode are already base64-encoded │ │ │ │ -and delimited with a character that is not legal in the base64 encoding, this │ │ │ │ -flag does not modify the extraction's mode output (i.e., you will not have │ │ │ │ -to decode the output data twice). │ │ │ │ -

│ │ │ │ -  │ │ │ │ -

OPTIONS PARSING

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -You can terminate program options parsing via a standard double-dash (--) │ │ │ │ -pseudo-option. │ │ │ │ -It is highly recommended to always do so. │ │ │ │ -

│ │ │ │ - │ │ │ │ -If you pass removal transformation operations or an extraction key-value pair │ │ │ │ -starts with a dash (-), passing the options terminator is mandatory, even │ │ │ │ -if no actual options are used. │ │ │ │ -Otherwise, transformation operations or extraction key-value pairs will be │ │ │ │ -interpreted as options to the program, which will almost certainly lead to an │ │ │ │ -error. │ │ │ │ -

│ │ │ │ - │ │ │ │ -For example, passing "-clipboard" as a transformation operation without a │ │ │ │ -previous options terminator will be interpreted as the option "-c", with the │ │ │ │ -rest of the string modified into "-lipboard". │ │ │ │ -Since this program does not accept an option called "-l", it will terminate │ │ │ │ -with an error. │ │ │ │ -Even if the program does not terminate with an error due to an unknown option │ │ │ │ -being supplied, a degradation into options is certainly not what the original │ │ │ │ -transformation operation was supposed to represent. │ │ │ │ -  │ │ │ │ -

EXAMPLES

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -  │ │ │ │ -

TRANSFORMATIONS

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -For an options string such as │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ -calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' │ │ │ │ -'-clipboard' shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,foo:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -while calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' │ │ │ │ -'-clipboard=server' shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -Calling "x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' 'bar'" │ │ │ │ -shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo,bar:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -and calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' │ │ │ │ -'+-bar' 'foo=gulp' '-clipboard=client' shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo=gulp,-bar:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ -For an options string such as │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo=bar,bar=baz,foo=oof:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ -you can get a compacted version by cheating a bit and providing a │ │ │ │ -transformation which will certainly be a no-operation using │ │ │ │ -x2gooptionsstring '-c' '--' │ │ │ │ -'nx/nx,clipboard=both,foo=bar,bar=baz,,foo=oof,:50' '-', which shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo=oof,bar=baz:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ - │ │ │ │ -  │ │ │ │ -

EXTRACTIONS

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -For an options string such as │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - nx/nx,clipboard=both,foo=bar,-=-,,bar=baz,foo=oof:50
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ -Calling x2gooptionsstring '-e' '--' │ │ │ │ -'nx/nx,clipboard=both,foo=bar,-=-,bar=baz,foo=oof,:50' 'foo' shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - Zm9vPW9vZg==
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ -while calling x2gooptionsstring '-e' '--' │ │ │ │ -'nx/nx,clipboard=both,foo=bar,-=-,bar=baz,foo=oof,:50' 'bar' '' │ │ │ │ -'clipboard=none' '-' shall return │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -

│ │ │ │ - YmFyPWJheg==|||LT0t
│ │ │ │ -
│ │ │ │ -
│ │ │ │ - │ │ │ │ - │ │ │ │ -
│ │ │ │ - │ │ │ │ -  │ │ │ │ -

AUTHOR

│ │ │ │ - │ │ │ │ - │ │ │ │ - │ │ │ │ -This manual has been written by │ │ │ │ -Mihai Moldovan <ionic@ionic.de> <mailto:ionic@ionic.de> for the X2Go │ │ │ │ -project (<https://www.x2go.org>). │ │ │ │ -

│ │ │ │ - │ │ │ │ -

│ │ │ │ - 

Index

│ │ │ │ -
│ │ │ │ -
NAME
│ │ │ │ -
SYNOPSIS
│ │ │ │ -
DESCRIPTION
│ │ │ │ -
OPTIONS
│ │ │ │ -
│ │ │ │ -
OPTIONS PARSING
│ │ │ │ -
│ │ │ │ -
EXAMPLES
│ │ │ │ -
│ │ │ │ -
TRANSFORMATIONS
│ │ │ │ -
EXTRACTIONS
│ │ │ │ -
│ │ │ │ -
AUTHOR
│ │ │ │ -
│ │ │ │ -
│ │ │ │ -This document was created by │ │ │ │ -man2html, │ │ │ │ -using the manual pages.
│ │ │ │ -Time: 14:10:47 GMT, September 23, 2023 │ │ │ │ - │ │ │ │ - │ │ │ │ +Invalid Man Page │ │ │ │ + │ │ │ │ +

Invalid Man Page

│ │ │ │ +The requested file man/man1/x2gooptionsstring.1 is not a valid (unformatted) man page. │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -1,174 +1,4 @@ │ │ │ │ │ -Content-type: text/html; charset=UTF-8 │ │ │ │ │ -************ XX22GGOOOOPPTTIIOONNSSSSTTRRIINNGG ************ │ │ │ │ │ -Section: General Commands Manual (1) │ │ │ │ │ -Updated: 2023-09-23 │ │ │ │ │ -_I_n_d_e_x _R_e_t_u_r_n_ _t_o_ _M_a_i_n_ _C_o_n_t_e_n_t_s │ │ │ │ │ -=============================================================================== │ │ │ │ │ -  │ │ │ │ │ -********** NNAAMMEE ********** │ │ │ │ │ -x2gooptionsstring - X2Go Agent Options String Manipulator and Extractor   │ │ │ │ │ -********** SSYYNNOOPPSSIISS ********** │ │ │ │ │ - xx22ggooooppttiioonnssssttrriinngg ----hheellpp|--hh|--?? │ │ │ │ │ - xx22ggooooppttiioonnssssttrriinngg ----mmaann │ │ │ │ │ - xx22ggooooppttiioonnssssttrriinngg [<----mmooddee|--mm><==| >tt[rraannssffoorrmm]|--tt] [----ccoommppaacctt|--cc] [----bbaassee6644|-- │ │ │ │ │ - bb] [----ddeebbuugg|--dd] [----] options_string [++]|--key[==value] ... │ │ │ │ │ - xx22ggooooppttiioonnssssttrriinngg <----mmooddee|--mm><==| >ee[xxttrraacctt]|--ee [----bbaassee6644|--bb] [----ddeebbuugg|--dd] [---- │ │ │ │ │ - ] options_string key[==value] ... │ │ │ │ │ -  │ │ │ │ │ -********** DDEESSCCRRIIPPTTIIOONN ********** │ │ │ │ │ -xx22ggooooppttiioonnssssttrriinngg is a utility for manipulating and extracting data from │ │ │ │ │ -options strings as passed to XX22GGoo//NNXX AAggeenntt. For more information about │ │ │ │ │ -supported options strings, refer to the OPTIONS STRINGS section in the X2Go:: │ │ │ │ │ -Server::Agent::NX::Options documentation. │ │ │ │ │ -For full support of options string, which are allowed (but not recommended) to │ │ │ │ │ -include binary data, the special ----bbaassee6644|--bb switch is supported. If given, all │ │ │ │ │ -arguments other than flags must be base64-encoded (making it possible to pass │ │ │ │ │ -binary data via shells, for instance). The program's output, minus potentially │ │ │ │ │ -debugging messages, will also be base64-encoded. │ │ │ │ │ -Currently, two modes are supported: │ │ │ │ │ - Transform (default) │ │ │ │ │ - Transformation mode is enabled by default if no mode has been explicitly │ │ │ │ │ - selected. │ │ │ │ │ - Call this program with optional flags, the options string as the first │ │ │ │ │ - parameter and the transformations to be carried out as additional │ │ │ │ │ - parameters. At least one additional parameter (i.e., a transformation) │ │ │ │ │ - must be provided. Transformations are described here briefly, but also in │ │ │ │ │ - the TRANSFORMATIONS section in the X2Go::Server::Agent::NX::Options │ │ │ │ │ - documentation. │ │ │ │ │ - It can either add, remove or replace components. │ │ │ │ │ - To add or replace a component, pass key[==value] or ++key[==value] as a │ │ │ │ │ - parameter. The latter syntax is useful if key starts with a dash and │ │ │ │ │ - would therefore be interpreted as a removal operation. If the options │ │ │ │ │ - string does not include a kkeeyy key, it will be appended to the end of the │ │ │ │ │ - options string. If it already exists, either with no value or a different │ │ │ │ │ - value, the component will be replaced with the provided value. │ │ │ │ │ - To fully remove a component, pass --key. To only remove it if it is set to │ │ │ │ │ - a specific value, pass --key==value. │ │ │ │ │ - Use the ----ccoommppaacctt option to minimize the original options string, │ │ │ │ │ - removing duplicated and empty entries. │ │ │ │ │ - Assuming no error happened, the resulting options string is written to │ │ │ │ │ - ssttddoouutt. │ │ │ │ │ - Extract │ │ │ │ │ - Extraction mode must be explicitly requested using the --ee or <----mmooddee|-- │ │ │ │ │ - mm><==| >ee[xxttrraacctt] flags. │ │ │ │ │ - Call this program with optional flags, the options string as the first │ │ │ │ │ - parameter and key-value pairs to be extracted as additional parameters. │ │ │ │ │ - At least one additional parameter (i.e., a key-value pair to extract) │ │ │ │ │ - must be provided. │ │ │ │ │ - A degenerated key-value pair without an explicit value can be used to │ │ │ │ │ - test for the existence of a key and extract its value at the same time. │ │ │ │ │ - A full, proper key-value pair can be used to test for the existence of a │ │ │ │ │ - key-value pair exactly as provided. │ │ │ │ │ - Assuming no error happened, the extracted key-value pairs will be written │ │ │ │ │ - to ssttddoouutt. Each pair will be base64-encoded and, if multiple key-value │ │ │ │ │ - pairs to extract have been provided, delimited via ppiippee characters ("|"). │ │ │ │ │ - Key-value pairs which haven't been found in the original options string, │ │ │ │ │ - as well as potentially an empty key-value pair, will be represented as │ │ │ │ │ - empty fields. │ │ │ │ │ -Refer to the OPTIONS PARSING section for a description of when and how to │ │ │ │ │ -terminate options passed to this program.   │ │ │ │ │ -********** OOPPTTIIOONNSS ********** │ │ │ │ │ - ----hheellpp|--??|--hh │ │ │ │ │ - Print a brief help message and exits. │ │ │ │ │ - ----mmaann │ │ │ │ │ - Prints the manual page and exits. │ │ │ │ │ - ----ddeebbuugg|--dd │ │ │ │ │ - Enables noisy debug output. │ │ │ │ │ - --tt │ │ │ │ │ - Shorthand for ----mmooddee==ttrraannssffoorrmm. │ │ │ │ │ - --ee │ │ │ │ │ - Shorthand for ----mmooddee==eexxttrraacctt. │ │ │ │ │ - <----mmooddee|--mm><==| >mode string │ │ │ │ │ - Selects a specific program mode. │ │ │ │ │ - Currently, the following mode strings are supported: │ │ │ │ │ - • │ │ │ │ │ - transform │ │ │ │ │ - • │ │ │ │ │ - extract │ │ │ │ │ - Mode strings can be abbreviated, as long as the abbreviation is │ │ │ │ │ - uniquely selecting one mode exactly. │ │ │ │ │ - ----ccoommppaacctt|--cc │ │ │ │ │ - Remove duplicate and empty entries after the initial parsing. The order │ │ │ │ │ - of arguments is preserved in a first-seen fashion. │ │ │ │ │ - This option is only available in ttrraannssffoorrmmaattiioonn mmooddee. It will be silently │ │ │ │ │ - ignored in eexxttrraaccttiioonn mmooddee, as compaction is a pre-requisite and done │ │ │ │ │ - automatically during extraction. │ │ │ │ │ - ----bbaassee6644|--bb │ │ │ │ │ - Enable a special full base64 mode. │ │ │ │ │ - Any binary data can be given and output by this program in this mode, │ │ │ │ │ - even when operating on a shell. │ │ │ │ │ - Input parameters must always be provided encoded in base64 form. │ │ │ │ │ - Likewise, the program will always output data encoded in a base64 form. │ │ │ │ │ - Since key-value pairs returned in extraction mode are already base64- │ │ │ │ │ - encoded and delimited with a character that is not legal in the base64 │ │ │ │ │ - encoding, this flag does not modify the extraction's mode output (i.e., │ │ │ │ │ - you will nnoott have to decode the output data twice). │ │ │ │ │ -  │ │ │ │ │ -******** OOPPTTIIOONNSS PPAARRSSIINNGG ******** │ │ │ │ │ -You can terminate program options parsing via a standard double-dash (---- │ │ │ │ │ -) pseudo-option. It is hhiigghhllyy rreeccoommmmeennddeedd to always do so. │ │ │ │ │ -If you pass removal transformation operations or an extraction key-value pair │ │ │ │ │ -starts with a dash (--), passing the options terminator is mmaannddaattoorryy, even if no │ │ │ │ │ -actual options are used. Otherwise, transformation operations or extraction │ │ │ │ │ -key-value pairs will be interpreted as options to the program, which will │ │ │ │ │ -almost certainly lead to an error. │ │ │ │ │ -For example, passing "-clipboard" as a transformation operation without a │ │ │ │ │ -previous options terminator will be interpreted as the option "-c", with the │ │ │ │ │ -rest of the string modified into "-lipboard". Since this program does not │ │ │ │ │ -accept an option called "-l", it will terminate with an error. Even if the │ │ │ │ │ -program does not terminate with an error due to an unknown option being │ │ │ │ │ -supplied, a degradation into options is certainly not what the original │ │ │ │ │ -transformation operation was supposed to represent.   │ │ │ │ │ -********** EEXXAAMMPPLLEESS ********** │ │ │ │ │ -  │ │ │ │ │ -******** TTRRAANNSSFFOORRMMAATTIIOONNSS ******** │ │ │ │ │ -For an options string such as │ │ │ │ │ - nx/nx,clipboard=both,foo:50 │ │ │ │ │ - calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' '-clipboard' │ │ │ │ │ - shall return │ │ │ │ │ - nx/nx,foo:50 │ │ │ │ │ - while calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' '- │ │ │ │ │ - clipboard=server' shall return │ │ │ │ │ - nx/nx,clipboard=both,foo:50 │ │ │ │ │ - Calling "x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' 'bar'" │ │ │ │ │ - shall return │ │ │ │ │ - nx/nx,clipboard=both,foo,bar:50 │ │ │ │ │ - and calling x2gooptionsstring '--' 'nx/nx,clipboard=both,foo:50' '+-bar' │ │ │ │ │ - 'foo=gulp' '-clipboard=client' shall return │ │ │ │ │ - nx/nx,clipboard=both,foo=gulp,-bar:50 │ │ │ │ │ -For an options string such as │ │ │ │ │ - nx/nx,clipboard=both,foo=bar,bar=baz,foo=oof:50 │ │ │ │ │ - you can get a compacted version by cheating a bit and providing a │ │ │ │ │ - transformation which will certainly be a no-operation using │ │ │ │ │ - x2gooptionsstring '-c' '--' 'nx/ │ │ │ │ │ - nx,clipboard=both,foo=bar,bar=baz,,foo=oof,:50' '-', which shall return │ │ │ │ │ - nx/nx,clipboard=both,foo=oof,bar=baz:50 │ │ │ │ │ -  │ │ │ │ │ -******** EEXXTTRRAACCTTIIOONNSS ******** │ │ │ │ │ -For an options string such as │ │ │ │ │ - nx/nx,clipboard=both,foo=bar,-=-,,bar=baz,foo=oof:50 │ │ │ │ │ - Calling x2gooptionsstring '-e' '--' 'nx/nx,clipboard=both,foo=bar,- │ │ │ │ │ - =-,bar=baz,foo=oof,:50' 'foo' shall return │ │ │ │ │ - Zm9vPW9vZg== │ │ │ │ │ - while calling x2gooptionsstring '-e' '--' 'nx/nx,clipboard=both,foo=bar,- │ │ │ │ │ - =-,bar=baz,foo=oof,:50' 'bar' '' 'clipboard=none' '-' shall return │ │ │ │ │ - YmFyPWJheg==|||LT0t │ │ │ │ │ -  │ │ │ │ │ -********** AAUUTTHHOORR ********** │ │ │ │ │ -This manual has been written by Mihai Moldovan <_i_o_n_i_c_@_i_o_n_i_c_._d_e> for the X2Go project (<_h_t_t_p_s_:_/_/_w_w_w_._x_2_g_o_._o_r_g>). │ │ │ │ │ -=============================================================================== │ │ │ │ │ -  │ │ │ │ │ -********** IInnddeexx ********** │ │ │ │ │ - _N_A_M_E │ │ │ │ │ - _S_Y_N_O_P_S_I_S │ │ │ │ │ - _D_E_S_C_R_I_P_T_I_O_N │ │ │ │ │ - _O_P_T_I_O_N_S │ │ │ │ │ - _O_P_T_I_O_N_S_ _P_A_R_S_I_N_G │ │ │ │ │ - _E_X_A_M_P_L_E_S │ │ │ │ │ - _T_R_A_N_S_F_O_R_M_A_T_I_O_N_S │ │ │ │ │ - _E_X_T_R_A_C_T_I_O_N_S │ │ │ │ │ - _A_U_T_H_O_R │ │ │ │ │ -=============================================================================== │ │ │ │ │ -This document was created by _m_a_n_2_h_t_m_l, using the manual pages. │ │ │ │ │ -Time: 14:10:47 GMT, September 23, 2023 │ │ │ │ │ +Status: 403 Forbidden Content-type: text/html; charset=UTF-8 │ │ │ │ │ +************ IInnvvaalliidd MMaann PPaaggee ************ │ │ │ │ │ +The requested file man/man1/x2gooptionsstring.1 is not a valid (unformatted) │ │ │ │ │ +man page.