NEX-9338 improve the layout of the crash directory
Reviewed by: Sanjay Nadkarni <sanjay.nadkarni@nexenta.com>
Reviewed by: Steve Peng <steve.peng@nexenta.com>

*** 1,32 ****
  '\" te
  .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
  .\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
! .\" Copyright 2013 Nexenta Systems, Inc.  All Rights Reserved.
! .TH SAVECORE 1M "Jan 30, 2013"
  .SH NAME
  savecore \- save a crash dump of the operating system
  .SH SYNOPSIS
  .LP
  .nf
  \fB/usr/bin/savecore\fR [\fB-Lvd\fR] [\fB-f\fR \fIdumpfile\fR] [\fIdirectory\fR]
  .fi
  
  .SH DESCRIPTION
- .sp
  .LP
  The \fBsavecore\fR utility saves a crash dump of the kernel (assuming that one
  was made) and writes a reboot message in the shutdown log. By default, it is
  invoked by the \fBdumpadm\fR service each time the system boots.
  .sp
  .LP
  Depending on the \fBdumpadm\fR(1M) configuration \fBsavecore\fR saves either
  the compressed or uncompressed crash dump. The compressed crash dump is saved in
! the file \fIdirectory\fR\fB/vmdump.\fR\fIn\fR.
  \fBsavecore\fR saves the uncompressed crash dump data in the file
! \fIdirectory\fR\fB/vmcore.\fR\fIn\fR and the kernel's namelist in
! \fIdirectory\fR\fB/unix.\fR\fIn.\fR The trailing \fIn\fR in the
  pathnames is replaced by a number which grows every time \fBsavecore\fR is run
  in that directory.
  .sp
  .LP
  Before writing out a crash dump, \fBsavecore\fR reads a number from the file
--- 1,32 ----
  '\" te
  .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
  .\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
! .\" Copyright 2017 Nexenta Systems, Inc.  All Rights Reserved.
! .TH SAVECORE 1M "Jan 08, 2017"
  .SH NAME
  savecore \- save a crash dump of the operating system
  .SH SYNOPSIS
  .LP
  .nf
  \fB/usr/bin/savecore\fR [\fB-Lvd\fR] [\fB-f\fR \fIdumpfile\fR] [\fIdirectory\fR]
  .fi
  
  .SH DESCRIPTION
  .LP
  The \fBsavecore\fR utility saves a crash dump of the kernel (assuming that one
  was made) and writes a reboot message in the shutdown log. By default, it is
  invoked by the \fBdumpadm\fR service each time the system boots.
  .sp
  .LP
  Depending on the \fBdumpadm\fR(1M) configuration \fBsavecore\fR saves either
  the compressed or uncompressed crash dump. The compressed crash dump is saved in
! the file \fIdirectory\fR/data/uuid\fB/vmdump.\fR\fIn\fR, where uuid is the OS
! instance UUID of the image that crashed.
  \fBsavecore\fR saves the uncompressed crash dump data in the file
! \fIdirectory\fR/data/uuid\fB/vmcore.\fR\fIn\fR and the kernel's namelist in
! \fIdirectory\fR/data/uuid\fB/unix.\fR\fIn.\fR The trailing \fIn\fR in the
  pathnames is replaced by a number which grows every time \fBsavecore\fR is run
  in that directory.
  .sp
  .LP
  Before writing out a crash dump, \fBsavecore\fR reads a number from the file
*** 40,50 ****
  .LP
  The \fBsavecore\fR utility also logs a reboot message using facility
  \fBLOG_AUTH\fR (see \fBsyslog\fR(3C)). If the system crashed as a result of a
  panic, \fBsavecore\fR logs the panic string too.
  .SH OPTIONS
- .sp
  .LP
  The following options are supported:
  .sp
  .ne 2
  .na
--- 40,49 ----
*** 95,141 ****
  .RS 15n
  Verbose. Enables verbose error messages from \fBsavecore\fR.
  .RE
  
  .SH OPERANDS
- .sp
  .LP
  The following operands are supported:
  .sp
  .ne 2
  .na
  \fB\fIdirectory\fR\fR
  .ad
  .RS 13n
  Save the crash dump files to the specified directory. If \fIdirectory\fR is not
! specified, \fBsavecore\fR saves the crash dump files to the default
! \fBsavecore\fR \fIdirectory\fR, configured by \fBdumpadm\fR(1M).
  .RE
  
  .SH FILES
- .sp
  .ne 2
  .na
! \fB\fIdirectory\fR\fB/vmdump.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
  .sp
  .ne 2
  .na
! \fB\fIdirectory\fR\fB/vmcore.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
  .sp
  .ne 2
  .na
! \fB\fIdirectory\fR\fB/unix.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
--- 94,139 ----
  .RS 15n
  Verbose. Enables verbose error messages from \fBsavecore\fR.
  .RE
  
  .SH OPERANDS
  .LP
  The following operands are supported:
  .sp
  .ne 2
  .na
  \fB\fIdirectory\fR\fR
  .ad
  .RS 13n
  Save the crash dump files to the specified directory. If \fIdirectory\fR is not
! specified, \fBsavecore\fR saves the crash dump to the default
! \fBsavecore\fR \fIdirectory\fR, configured by \fBdumpadm\fR(1M), and files are
! stored under distinct \fB\fIdirectory\fR/data/uuid folder.
  .RE
  
  .SH FILES
  .ne 2
  .na
! \fB\fIdirectory\fR/data/uuid\fB/vmdump.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
  .sp
  .ne 2
  .na
! \fB\fIdirectory\fR/data/uuid\fB/vmcore.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
  .sp
  .ne 2
  .na
! \fB\fIdirectory\fR/data/uuid\fB/unix.\fR\fIn\fR\fR
  .ad
  .RS 29n
  
  .RE
  
*** 165,180 ****
  .RS 29n
  default crash dump directory
  .RE
  
  .SH SEE ALSO
- .sp
  .LP
  \fBadb\fR(1), \fBmdb\fR(1), \fBsvcs\fR(1), \fBdd\fR(1M), \fBdumpadm\fR(1M),
  \fBsvcadm\fR(1M), \fBsyslog\fR(3C), \fBattributes\fR(5), \fBsmf\fR(5)
  .SH NOTES
- .sp
  .LP
  The system crash dump service is managed by the service management facility,
  \fBsmf\fR(5), under the service identifier:
  .sp
  .in +2
--- 163,176 ----