ArcShell

arcshell_logger.sh

Reference

log_set_default

Set all settings back to default values.

> log_set_default

log_show

Returns current coniguration settings.

> log_show

log_set_output

Sets the log output targets for the current session.

> log_set_output "targets"
# targets: List of numbers which determine output targets. 0 file, 1 stdout, 2 stderr.

log_set_file

Set the file being logged to a non-default file.

> log_set_file "file"
# file: Path to file you want to begin logging to.

log_follow

Tail the arcshell application log as a background process. ‘fg’ to bring to foreground.

> log_follow

log_quit

Kills the “log_follow” process if it is running.

> log_quit

log_open

Open ArcShell application log file in the default editor.

> log_open

log_terminal

Return text to standard out if the call is originating from a terminal.

> log_terminal "log_text"

log_boring

Log “boring” text to the application log file.

> log_boring [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_info

Log informational text to the application log file.

> log_info [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_notice

Log a ‘NOTICE’ to the current log file.

> log_notice [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_event

Log a ‘EVENT’ record to the current log file.

> log_event [-stdin] [-1|-2] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_data

Log a ‘DATA’ record to the current log file.

> log_data [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_message

Log a ‘MESSAGE’ record to the current log file.

> log_message [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_critical

Log a ‘CRITICAL’ record to the current log file.

> log_critical [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_warning

Log a ‘WARNING’ record to the current log file.

> log_warning [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_error

Log a ‘ERROR’ record to the current log file.

> log_error [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_fatal

Log a ‘FATAL’ record to the current log file.

> log_fatal [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_audit

Log a ‘AUDIT’ record to the current log file.

> log_audit [-stdin] [-1|-2] [-logkey,-l "X"] [-tags,-t "X,x"] "log_text"
# -stdin: Read standard input.
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.
# -logkey: A key to identify the primary source of the log entry.
# -tags: Tag list.
# log_text: Text to log.

log_detail

Log a set of details to the current log file. Assumes bulk of data is coming from standard input.

> log_detail [-1|-2]
# -1: Data is returned to standard out in addition to being logged.
# -2: Data is returned to standard error in addition to being logged.

log_truncate

Truncates the current log file.

> log_truncate

log_get

Return one or more lines from the application log file.

> log_get [X=1]
# X: Return last X lines from the log file.