scriptsequence

Package: WA2L/edrc 1.5.57
Section: Library Commands (3)
Updated: 28 November 2020
Index Return to Main Contents

 

NAME

scriptsequence - check if scripts are called in ascending order

 

SYNOPSIS

edrc/lib/scriptsequence [ -h ]

scriptsequence [ -a inform | -a query | -a cancel | -a init ]

 

AVAILABILITY

WA2L/edrc

 

DESCRIPTION

check if recovery scripts are called in ascending sequence. If not a message is printed or the script is aborted. scriptsequence must be called from a recovery script or _env file to give the user more awareness if the sequence is broken.

The scriptsequence command reads the contrib.doc(1m) tag # R: text to check if it is allowed to rerun a recovery script without a message/query.

If text in # R: text is set to YES, JA, OUI or SI and the related recovery script is started again, no message is printed or no query is performed.

 

OPTIONS

-a inform
if the script is started out of ascending sequence or if a script is started again and no # R: YES is found in the recovery script documentation, print an information WARNING message, but start the recovery script nevertheless.

-a query
if the script is started out of ascending sequence or if a script is started again and no # R: YES is found in the recovery script documentation, query the user if the script should be started or canceled.

-a cancel
if the script is started out of ascending sequence or if a script is started again and no # R: YES is found in the recovery script documentation, cancel the recovery script start.

-a init
force the scriptsequence command to re-read the script tree on next start.

Normally this is not necessary, but if recovery scripts were added/deleted the scriptsequence needs to re-read the script tree.

When the current edrc session is exited and a new session is started, it is also not needed to invoke scripttree -a init .

 

ENVIRONMENT

-

 

EXIT STATUS

0
no abnormality discovered.

1
scriptsequence is started from outside of a recovery script tree.

2
the script is started out of ascending sequence or the a script is started again and no # R: YES is found in the recovery script documentation and either -a cancel was invoked or the query to start/cancel the recovery script was answered to cancel.

4
usage displayed.

 

FILES

_env
environment file where scriptsequence is started. See edrc(1m) for more information.

<recovery script>
recovery script that is started, when a menupoint is called.

edrc/var/log/scriptsequence.log
log file of scriptsequence.

 

EXAMPLES

1. Usage example (query to abort or not):
  scriptsequence || exit

2. Usage example (inform only):
  scriptsequence -a inform || exit

 

SEE ALSO

edrcintro(1), contrib.doc(1m), contrib.edrc(1m), contrib.scriptsequence(1m)

 

NOTES

-

 

BUGS

-

 

AUTHOR

scriptsequence was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2020 Christian Walther

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:54:22 GMT, August 28, 2024