|
|
|
@ -152,8 +152,71 @@ int Xorriso__preset_signal_behavior(int behavior, int flag);
|
|
|
|
|
int Xorriso_new(struct XorrisO ** xorriso, char *progname, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Interpret certain commands which shall get into effect before the
|
|
|
|
|
libraries get initialized:
|
|
|
|
|
/* Note: Between Xorriso_new() and the next call Xorriso_startup_libraries()
|
|
|
|
|
there may be called the special command interpreter
|
|
|
|
|
Xorriso_prescan_args().
|
|
|
|
|
The other command interpreters may be used only after
|
|
|
|
|
Xorriso_startup_libraries(). The same restriction applies to the
|
|
|
|
|
calls of the Options API further below.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Mandatory call:
|
|
|
|
|
It has to be made before calling any function listed below this point.
|
|
|
|
|
Only exception is the special command interpreter Xorriso_prescan_args().
|
|
|
|
|
|
|
|
|
|
Make global library initializations.
|
|
|
|
|
This must be done with the first xorriso object that gets created and
|
|
|
|
|
with the first xorriso object that gets created after Xorriso_destroy(,1).
|
|
|
|
|
@param xorriso The context object.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return <=0 error , >0 success
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_startup_libraries(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Note: After library startup, you may run Command Interpreters or call
|
|
|
|
|
functions from the Options API.
|
|
|
|
|
|
|
|
|
|
Wenn all desired activities are done, you may check whether there are
|
|
|
|
|
uncommited chages pending, compute an exit value, destroy the XorrisO
|
|
|
|
|
object, and exit your program.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Inquire whether option -commit would make sense.
|
|
|
|
|
@param xorriso The context object to inquire.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return 0= -commit would have nothing to do
|
|
|
|
|
1= a new image session would emerge at -commit
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_change_is_pending(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Compute the exit value from the recorded maximum event severity.
|
|
|
|
|
@param xorriso The context object to inquire.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return The computed exit value
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_make_return_value(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Mandatory call:
|
|
|
|
|
Destroy xorriso object when it is no longer needed.
|
|
|
|
|
@param xorriso The context object to destroy. *xorriso will become NULL.
|
|
|
|
|
@param flag bit0= Perform global library shutdown.
|
|
|
|
|
Use only with last xorriso object to be destroyed.
|
|
|
|
|
@return <=0 error, >0 success
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_destroy(struct XorrisO **xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* --------------------- Command Interpreters ------------------- */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* This special interpreter is eventually called between Xorriso_new() and
|
|
|
|
|
Xorriso_startup_libraries(). It interprets certain commands which shall
|
|
|
|
|
get into effect before the libraries get initialized:
|
|
|
|
|
-abort_on , -report_about , -return_with , -list_delimiter
|
|
|
|
|
Some commands get executed only if they are the only command in argv:
|
|
|
|
|
-prog_help , -help , -no_rc
|
|
|
|
@ -176,19 +239,6 @@ int Xorriso_prescan_args(struct XorrisO *xorriso, int argc, char **argv,
|
|
|
|
|
int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Mandatory call:
|
|
|
|
|
It has to be made before calling any function listed below this point.
|
|
|
|
|
|
|
|
|
|
Make global library initializations.
|
|
|
|
|
This must be done with the first xorriso object that gets created and
|
|
|
|
|
with the first xorriso object that gets created after Xorriso_destroy(,1).
|
|
|
|
|
@param xorriso The context object.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return <=0 error , >0 success
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_startup_libraries(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Read and interpret commands from eventual startup files as listed in
|
|
|
|
|
man xorriso.
|
|
|
|
|
@param xorriso The context object in which to perform the commands.
|
|
|
|
@ -270,33 +320,6 @@ int Xorriso_execute_option(struct XorrisO *xorriso, char *line, int flag);
|
|
|
|
|
int Xorriso_dialog(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Inquire whether option -commit would make sense.
|
|
|
|
|
@param xorriso The context object to inquire.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return 0= -commit would have nothing to do
|
|
|
|
|
1= a new image session would emerge at -commit
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_change_is_pending(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Compute the exit value from the recorded maximum event severity.
|
|
|
|
|
@param xorriso The context object to inquire.
|
|
|
|
|
@param flag unused yet, submit 0
|
|
|
|
|
@return The computed exit value
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_make_return_value(struct XorrisO *xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Mandatory call:
|
|
|
|
|
Destroy xorriso object when it is no longer needed.
|
|
|
|
|
@param xorriso The context object to destroy. *xorriso will become NULL.
|
|
|
|
|
@param flag bit0= Perform global library shutdown.
|
|
|
|
|
Use only with last xorriso object to be destroyed.
|
|
|
|
|
@return <=0 error, >0 success
|
|
|
|
|
*/
|
|
|
|
|
int Xorriso_destroy(struct XorrisO **xorriso, int flag);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* --------------------- Problem Status and Message API ------------------- */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|