xref: /freebsd/usr.sbin/diskinfo/diskinfo.8 (revision 851b967a27b2ada7193bb5076f33b5be7d8a07ea)
1a362eb63SPoul-Henning Kamp.\"
2a362eb63SPoul-Henning Kamp.\" Copyright (c) 2003 Poul-Henning Kamp
3a362eb63SPoul-Henning Kamp.\" All rights reserved.
4a362eb63SPoul-Henning Kamp.\"
5a362eb63SPoul-Henning Kamp.\" Redistribution and use in source and binary forms, with or without
6a362eb63SPoul-Henning Kamp.\" modification, are permitted provided that the following conditions
7a362eb63SPoul-Henning Kamp.\" are met:
8a362eb63SPoul-Henning Kamp.\" 1. Redistributions of source code must retain the above copyright
9a362eb63SPoul-Henning Kamp.\"    notice, this list of conditions and the following disclaimer.
10a362eb63SPoul-Henning Kamp.\" 2. Redistributions in binary form must reproduce the above copyright
11a362eb63SPoul-Henning Kamp.\"    notice, this list of conditions and the following disclaimer in the
12a362eb63SPoul-Henning Kamp.\"    documentation and/or other materials provided with the distribution.
13a362eb63SPoul-Henning Kamp.\" 3. The names of the authors may not be used to endorse or promote
14a362eb63SPoul-Henning Kamp.\"    products derived from this software without specific prior written
15a362eb63SPoul-Henning Kamp.\"    permission.
16a362eb63SPoul-Henning Kamp.\"
17a362eb63SPoul-Henning Kamp.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18a362eb63SPoul-Henning Kamp.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19a362eb63SPoul-Henning Kamp.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20a362eb63SPoul-Henning Kamp.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21a362eb63SPoul-Henning Kamp.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22a362eb63SPoul-Henning Kamp.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23a362eb63SPoul-Henning Kamp.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24a362eb63SPoul-Henning Kamp.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25a362eb63SPoul-Henning Kamp.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26a362eb63SPoul-Henning Kamp.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27a362eb63SPoul-Henning Kamp.\" SUCH DAMAGE.
28a362eb63SPoul-Henning Kamp.\"
29a362eb63SPoul-Henning Kamp.\" $FreeBSD$
30a362eb63SPoul-Henning Kamp.\"
319046f8cdSRuslan Ermilov.Dd November 9, 2004
32a362eb63SPoul-Henning Kamp.Dt DISKINFO 8
33a362eb63SPoul-Henning Kamp.Os
34a362eb63SPoul-Henning Kamp.Sh NAME
35a362eb63SPoul-Henning Kamp.Nm diskinfo
36a362eb63SPoul-Henning Kamp.Nd get information about disk device
37a362eb63SPoul-Henning Kamp.Sh SYNOPSIS
38a362eb63SPoul-Henning Kamp.Nm
399046f8cdSRuslan Ermilov.Op Fl ctv
40a362eb63SPoul-Henning Kamp.Ar disk ...
41a362eb63SPoul-Henning Kamp.Sh DESCRIPTION
42a362eb63SPoul-Henning KampThe
43a362eb63SPoul-Henning Kamp.Nm
44a388918dSRuslan Ermilovutility prints out information about a disk device,
45a388918dSRuslan Ermilovand optionally runs a naive performance test on the device.
46a362eb63SPoul-Henning Kamp.Pp
47a388918dSRuslan ErmilovIf given no arguments, the output will be a single line per specified device
48a362eb63SPoul-Henning Kampwith the following fields: device name, sectorsize, media size in bytes,
49851b967aSAlexander Motinmedia size in sectors, stripe size, stripe offset, firmware cylinders,
50851b967aSAlexander Motinfirmware heads, and firmware sectors.
51a362eb63SPoul-Henning KampThe last three fields are only present if the information is available.
52a362eb63SPoul-Henning Kamp.Pp
53a362eb63SPoul-Henning KampIf given the
54a362eb63SPoul-Henning Kamp.Fl v
55a362eb63SPoul-Henning Kampoption, the fields will be printed one per line with a descriptive comment.
56a362eb63SPoul-Henning Kamp.Pp
57a362eb63SPoul-Henning KampThe
586a33b3c6SSøren Schmidt.Fl c
596a33b3c6SSøren Schmidtoption triggers a simple measurement of the I/O read command overhead.
606a33b3c6SSøren Schmidt.Pp
616a33b3c6SSøren SchmidtThe
62a362eb63SPoul-Henning Kamp.Fl t
63a388918dSRuslan Ermilovoption triggers a simple and rather naive benchmark of the disks seek
64a362eb63SPoul-Henning Kampand transfer performance.
65a362eb63SPoul-Henning Kamp.Sh HISTORY
66a388918dSRuslan ErmilovThe
67a362eb63SPoul-Henning Kamp.Nm
68a362eb63SPoul-Henning Kampcommand appeared in
69a388918dSRuslan Ermilov.Fx 5.1 .
7059a3c79dSRuslan Ermilov.Sh AUTHORS
7159a3c79dSRuslan Ermilov.An Poul-Henning Kamp
7259a3c79dSRuslan Ermilov.Sh BUGS
7359a3c79dSRuslan ErmilovThere are in order of increasing severity: lies,
7459a3c79dSRuslan Ermilovdamn lies, statistics, and computer benchmarks.
75