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 +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"
+.\" 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
-.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.
+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\fB/vmcore.\fR\fIn\fR and the kernel's namelist in
-\fIdirectory\fR\fB/unix.\fR\fIn.\fR The trailing \fIn\fR in the
+\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,11 +40,10 @@
 .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

@@ -95,47 +94,46 @@
 .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).
+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
-.sp
 .ne 2
 .na
-\fB\fIdirectory\fR\fB/vmdump.\fR\fIn\fR\fR
+\fB\fIdirectory\fR/data/uuid\fB/vmdump.\fR\fIn\fR\fR
 .ad
 .RS 29n
 
 .RE
 
 .sp
 .ne 2
 .na
-\fB\fIdirectory\fR\fB/vmcore.\fR\fIn\fR\fR
+\fB\fIdirectory\fR/data/uuid\fB/vmcore.\fR\fIn\fR\fR
 .ad
 .RS 29n
 
 .RE
 
 .sp
 .ne 2
 .na
-\fB\fIdirectory\fR\fB/unix.\fR\fIn\fR\fR
+\fB\fIdirectory\fR/data/uuid\fB/unix.\fR\fIn\fR\fR
 .ad
 .RS 29n
 
 .RE
 

@@ -165,16 +163,14 @@
 .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