TAKE 784355 - Improvement request for xfsdump/xfsrestore exit codes

[Andrew Gildfind <ajag@snort.melbourne.sgi.com>]

Merge IRIX mods to Linux, the source has diverged a lot... we should plan on
doing some reconciliation for the 6.5.15 timeframe...

Andrew

Date:  Thu Aug 30 18:39:05 PDT 2001
Workarea:  snort.melbourne.sgi.com:/home/ajag/isms/slinx

The following file(s) were checked into:
  bonnie.engr.sgi.com:/isms/slinx/2.4.x-xfs


Modid:  2.4.x-xfs:slinx:101969a
cmd/xfsdump/dump/content.c - 1.8
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Wrap returns with mlog_exit, sprinkle hints.

cmd/xfsdump/common/types.h - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Expand set of return codes.

cmd/xfsdump/common/stream.h - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Add new stream definitions.

cmd/xfsdump/common/stream.c - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Expand stream structure to include exit_code, return and hint fields, this 
	  provides a place to store per-stream exit status information.
	  Change stream_register/stream_unregister to stream_register/stream_dead/stream_free,
	  add explicit stream states S_FREE, S_RUNNING, S_ZOMBIE.
	  Add stream_find/stream_find_all and change stream_getix to now lock the 
	  stream list. Add stream_set* functions - we don't want people holding
	  pointers into this structure without locks.

cmd/xfsdump/common/qlock.c - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Add MLOG_BARE flag to all mlog calls. Calls to mlog will not attempt to
	  acquire new locks, they will just print the bare text.

cmd/xfsdump/common/mlog.h - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Add mlog_exit, mlog_exit_hint macro wrappers that pass file/line to 
	  function call.

cmd/xfsdump/common/mlog.c - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Add mlog_main_exit_* variables - provide a place to put return codes from the
	  main process (as opposed to the streams). Add _mlog_exit() and _mlog_exit_hint()
	  functions, define rvs structure mapping return codes to textual error codes &
	  descriptions. Add mlog_exit_flush that prints stream status and dump summary.
	  - Fix structure initialisation for Linux, remove useless assert.
	  - Make sure hint masks return value for all conditions.

cmd/xfsdump/common/main.c - 1.7
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Wrap all return values with a call to mlog_exit() which records the exit code
	  and return value. Group calls to lock initialisation functions. Add mlog_exit() 
	  call to usage() as we know that any call to usage precedes an exit.
	  - Add RV_INCOMPLETE exit hint for incomplete dumps, unless some other
	  hint has already been given.

cmd/xfsdump/common/dlog.c - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Add hints for keyboard interrupt.

cmd/xfsdump/common/cldmgr.c - 1.2
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Replace stream_unregister() with stream_dead()

cmd/xfsdump/restore/content.c - 1.12
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Wrap returns with mlog_exit, sprinkle hints.
	  - Add hint to DEVICE_NONREMOVABLE in newmedia block, unless an error has
	  been signalled elsewhere we don't really want to log a failure.

cmd/xfsdump/man/man8/xfsdump.8 - 1.7
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Describe Dump Status message, and error codes.

cmd/xfsdump/man/man8/xfsrestore.8 - 1.4
	- merge of irix6.5f-melb:eoe:06291a, irix6.5f-melb:eoe:06307a,
	  and irix6.5f-melb:eoe:06315a, see PV #784355
	  - Describe Restore Status message, and error codes.