Manual Reference Pages  - gen_man_stub_test2 (1)

NAME

gen_man_stub_test2 - displays raw or processed output from metastat.

CONTENTS

Arguments	Author	Bugs	Called By	Calls	Commands
Description	Diagnostics	Documented Version	Environment	Examples	Exit Status
Files	Globals	Hints	Hosts This File Is Identical On	Input	Input Generated By
Locals	Options	Output	Output Used By	Permissions	Rcs Information
Rcs.sh Version	Restrictions	Scripts	Security	See Also	Synopsis
Warning(s)

DOCUMENTED VERSION

1.5 - 2008/11/27 00:27:05

SYNOPSIS

gen_man_stub_test2 [[-S] | [-h | -p -i -tt -s setname]] [-x]* [-X]* {metastat_arguments}

DESCRIPTION

This script is various test cases for genmanstub.
Note: the following 2 comment lines are handy for testing very wide output.

ARGUMENTS

    {metastat_arguments}*

OPTIONS

-S	print summarized metastat output (default=print raw metastat output)
-h	passed through to metastat
-p	passed through to metastat
-x	does ’set -x’ (may be used in functions and external script calls) (see DIAGNOSTICS below)
-X	sets debugging level--the number of times -X is specified" (see DIAGNOSTICS below)

FILES

    asdf, zxcv

ENVIRONMENT

    Not sure what to use this section for.

SCRIPTS

sshbyname has numerious symbolic links to it--each symbolic link is a hostname of a host that can be ssh’ed to
    earneson/bin/asdf

HOSTS THIS FILE IS IDENTICAL ON

aa bb cc

GLOBALS

    ASDF=1234

LOCALS

    zxcv=1234

COMMANDS

n for next file, m:more, p:pg, v:view, q:quit

INPUT

not much

INPUT GENERATED BY

N/A

OUTPUT

    1) Raw output corresponds to the output from metastat
    2) Processed output looks like this.
        column 1: the array index of the element
        column 2: the metadevice name
        column 3: type of meta device; one of [stripe|concat|mirror|raid|logging|hotspare|SMconcat|SMstripe] (where SMconcat is a submirror-concat, and SMstripe is a submirror-stripe)
        column 9: the disk slices associated with the third submirror if mirrored

    a#   md  md_type cpy State        %sync SizeMB   diskpart_1                   diskpart_2                   diskpart_3                 
    __ [1]_ __[2]___ [3] ____________ _____ ________ ____________[4]____________  ____________[5]____________  ____________[6]____________
    1   d2   mirror   1 Okay                  27153 c0t9d0s4,c0t9d0s5,c0t1d0s3 
    2  d22 SMconcat   1 Okay                  27153 c0t9d0s4,c0t9d0s5,c0t1d0s3

OUTPUT USED BY

some-other-script

EXAMPLES

    Example of checking 4 directories on 3 volumes
        Blitzkrieg.earneson $ ckcurr -XXXX -V Wurtzite -v Wurtzite -p /Users/earneson/windozePC040627/Temp -v Blitzkrieg -p /Users/earneson/windozePC040627/Temp -v Avalanche -p /Users/earneson/windozePC040627/Temp

HINTS

1. To use this file as print test file to count columns use the "-t" option to truncate the very long column numbering rows near the top of this script
2. A2ps may have delegating enabled (cf. a2ps --list=defaults). If so, then it may assume you want another program to process the output first. For

RESTRICTIONS

- The -t flag (total) doesn not differentiate NFS and local filesystems and it probably should. - The -t flag (total) doesn not differentiate NFS and local filesystems and it probably should. - The -t flag (total) doesn not differentiate NFS and local filesystems and it probably should.

1. Only a limited subset of possible configurations are available for testing, and, hence the processed output processer does not know how to handle all possible cases.
2. The script assumes old style meta device names which must start with "d" are used
3. The script expects A row where the first word is "Content-Type:"

BUGS

1) The script is hard-coded to only print up to 3 mirrors.
2) The output columns for physical partitions is about 30 characters wide and will overflow if there are more than 3 slices

SECURITY

    Nothing
    to
    say.

RCS.SH VERSION

00008

RCS INFORMATION

$Id: lismeta,v 1.5 2008/11/27 00:27:05 earneson Exp $
$Author: earneson $
$Date: 2008/11/27 00:27:05 $
$Revision: 1.5 $
$Source: /Users/cvs/scripts/all/Users/earneson/bin/lismeta,v $
$State: Exp $

PERMISSIONS

rwxr-xr-x userUID staff

WARNING(S)

    Nothing to warn about.
40 - localize not found
41 - Can not find meta stat. Checked /usr/opt/SUNWmd/sbin/metastat and /usr/sbin/metastat.
42 - No new path components specified
45 - Test 45a
45 - Test45c
45 - Test45b

EXIT STATUS

51 - An unknown option was passed to the script, or syntax of the parameters is wrong.
51 - Unknown option >$errflag<
52 - Variable ejadir not set. Home directory not found.
53 - Can not find eja binary directory $ejadir/bin
56 - The USAGE was requested using -z or -?.
57 - Test message 57
58 - Test message 58

CALLS

uname, metastat, awk

CALLED BY

asdf, 1234
    /usr/local/bin/asdf

SEE ALSO

ssh(1) or ssh2(1)
    metastat(1M)

AUTHOR

Edwin Arneson

DIAGNOSTICS

-X Prints strings that are build in awk to be executed. The output of the command is read by awk. Marked with "cmd=".
-XX Nothing.
-XXX Nothing.
-XXXX Various debugging message as input lines are processed.
	The processing of metastat -p records are marked with "mdIN". The processing of metastat records are marked with "mdsIN" and "submdsIN"