org.opensuse.Agama1.Questions
New (IN s class, IN s text, IN as options, IN s default_option, IN a{ss} data, OUT o unnamed_arg5); NewWithPassword (IN s class, IN s text, IN as options, IN s default_option, IN a{ss} data, OUT o unnamed_arg5); Delete (IN o question); AddAnswerFile (IN s path);
Agama offers a mechanism to communicate with clients. The D-Bus service exports a *Questions* object that implements the *org.freedesktop.DBus.ObjectManager* interface. Individual questions are dynamically exported in a tree under the */org/opensuse/Agama1.Questions* path, for example:
~~~ /org/opensuse/Agama1/Questions /org/opensuse/Agama1/Questions/1 /org/opensuse/Agama1/Questions/2 /org/opensuse/Agama1/Questions/4 ~~~
Each D-Bus question implements its own set of interfaces, depending on the type of question. For example, a generic question implements *org.opensuse.Agama.Question1*. And a question asking for the activation of a LUKS device also implements *org.opensuse.Agama1.Questions.WithPassword*. Questions can be "unexported" from the ObjectManager tree. The service typically unexports a question when the question is answered and the answer is successfully read.
New (IN s class, IN s text, IN as options, IN s default_option, IN a{ss} data, OUT o unnamed_arg5);
similar questions asked multiple times or for matching
in automatic answers.
text
: human string with question text
options
: list of possible options that can be used as answer. Example
is "OK", "Cancel".
default_option
: safe default answer that is used e.g. for focus in UI
or by non-interactive answering. It has to be included
in options parameter.
data
: additional data that is specific to given question class. Can be
used for additional details about question that helps with UI
or with matching automatic answers.
Creates new generic question. Returns the object path of the created question.
IN s class
:string identifier of the same questions. Useful to identify
IN s text
:
IN as options
:
IN s default_option
:
IN a{ss} data
:
OUT o unnamed_arg5
:
NewWithPassword (IN s class, IN s text, IN as options, IN s default_option, IN a{ss} data, OUT o unnamed_arg5);
similar questions asked multiple times or for matching
in automatic answers.
text
: human string with question text
options
: list of possible options that can be used as answer. Example
is "OK", "Cancel".
default_option
: safe default answer that is used e.g. for focus in UI
or by non-interactive answering. It has to be included
in options parameter.
data
: additional data that is specific to given question class. Can be
used for additional details about question that helps with UI
or with matching automatic answers.
Creates new question with generic base and additional WithPassword interface. Returns the object path of the created question.
IN s class
:string identifier of the same questions. Useful to identify
IN s text
:
IN as options
:
IN s default_option
:
IN a{ss} data
:
OUT o unnamed_arg5
: