Initial commit of OpenSPARC T2 design and verification files.

[OpenSPARC-T2-DV] / tools / perl-5.8.0 / man / man3 / ScanTest.3

.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ScanTest 3"
.TH ScanTest 3 "2003-07-28" "perl v5.8.0" "User Contributed Perl Documentation"
.SH "NAME"
ScanTest \- Perl module for scan pattern generation.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use ScanTest;
.Ve
.PP
.Vb 1
\&  BlockFlow();
.Ve
.SH "ABSTRACT"
.IX Header "ABSTRACT"
.Vb 5
\&  ScanTest is a parameterizable package for automatic test pattern
\&  generation using FastScan. The package supports creation of the
\&  test procedure file, FastScan command file and execution script,
\&  and provides control for the generation and simulation of test
\&  patterns.
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The ScanTest module contains procedures to manage automatic test
pattern generation using FastScan. By default it exports the
procedure \*(L"BlockFlow\*(R". This procedure allows the user to generate
and simulate block level scan patterns. The routines called by
\&\*(L"BlockFlow\*(R" are generic, being tied to a project by means of a
configuration file \*(L"ScanTest.cfg\*(R".
.PP
Optionally the module exports the procedure \*(L"LibraryFlow\*(R". This
set of routines is specific to Niagara and is responsible for
generating test patterns for the m1 and u1 libraries. \*(L"LibraryFlow\*(R"
is not intended for general use and is not discussed further in this
document.
.Sh "\s-1EXPORT\s0"
.IX Subsection "EXPORT"
ScanTest exports the procedure \*(L"BlockFlow\*(R". The procedure takes
no arguments. Instead three levels of customization are
available:
.IP "Command Line Switches" 4
.IX Item "Command Line Switches"
Command line switches are the means by which users can tailor
the flow to suit their needs. Switches are provided to:
.RS 4
.IP "\(bu specify design files and top module" 4
.IX Item "specify design files and top module"
.PD 0
.IP "\(bu override default library settings" 4
.IX Item "override default library settings"
.IP "\(bu override default pin constraints" 4
.IX Item "override default pin constraints"
.IP "\(bu suppress intermediate file generation" 4
.IX Item "suppress intermediate file generation"
.IP "\(bu execute a partial flow sequence" 4
.IX Item "execute a partial flow sequence"
.IP "\(bu perform miscellaneous operations" 4
.IX Item "perform miscellaneous operations"
.RE
.RS 4
.PD
.Sp
A full list of switches and their defaults can be displayed by
specifying the \*(L"\-help\*(R" option.
.RE
.IP "Configuration File" 4
.IX Item "Configuration File"
The configuration file \*(L"ScanTest.cfg\*(R" contain default settings
for libraries, constrained pins and variables used in the
generation of intermediate files. The purpose of the configuration
file is to tailor the flow to the needs of the project. The
configuration file is released as a supplement to the package
and is not intended for modification by the user.
.IP "Psuedocode Files" 4
.IX Item "Psuedocode Files"
Psuedocode templates exist for the generation of the FastScan
test procedure file and command file (do file). The templates
identify the structure of the files. They mix verbatim syntax
with psuedocode constructs. The psuedocode is expanded at run
time to include variables contained in the configuration file
and iterated as necessary over a set of constrained pins.
.Sp
Currently the templates are released as a supplement to the
package and are not intended for modification by the user.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIscantest\fR\|(1), http://www.mentor.com/dft
.SH "AUTHOR"
.IX Header "AUTHOR"
Roger Mistely, <roger.mistely@sun.com>