[comp.unix.xenix] how to order a V3.2 driver design manual

buck@siswat.UUCP (A. Lester Buck) (12/27/88)

A while ago, Dimitri Rotow of Bell Technologies posted the following:

]I recently responded to a question asking for information on writing
]device drivers by suggesting some AT&T publications.  Over 30 people
]have since posted me with a request for the AT&T 800 number to use.  
]Here it is:
]
]To order AT&T documents, call their Customer Information Center at
]800-432-6600.  They take VISA and are very responsive.   The material
]you should order is:
]
]UNIX System V/386 Release 3.2 Integrated Software Development Guide (ISDG)
]
]and the 
]
]UNIX System V/386 Release 3, Block and Character Interface, Device Driver
]Reference Manual, Select Code 307-192.
]
]You are crazy to work on device driver sources without these two books.
]The ISDG in particular is one of the very best UNIX books ever written.
]It not only includes sources to floppy disk and other device drivers, it
]also provides a complete framework for installation scripts and other 
]vital stuff.
]
]Even though this is targeted at UNIX 3.2, it should be useful to all working
]in current releases of Microport, 386/ix, and SCO.
]
]We reprint the ISDG with the manual set for UNIX 3.2.

I finally got around to try ordering these two manuals and called the
800 number.  The Device Driver Reference Manual was easy with the
select code, but they could not find the ISDG from the above title
(and missing a select code).  I called Bell Tech for a select code,
but they couldn't find one on their documentation.  (They suggested
I buy their version of V3.2...)  I sent email to Dimitri Rotow but
never got a reply back.

Does the Integrated Software Design Guide exist as an AT&T publication
available for sale separately?  Does anyone know a select code
to use for this ISDG?

Thanks alot,


-- 
A. Lester Buck		...!uhnix1!moray!siswat!buck

paul@prcrs.UUCP (Paul Hite) (12/28/88)

In article <363@siswat.UUCP>, buck@siswat.UUCP (A. Lester Buck) writes:
> A while ago, Dimitri Rotow of Bell Technologies posted the following:
> 
> ]To order AT&T documents, call their Customer Information Center at
> ]800-432-6600.  They take VISA and are very responsive.
> ]
> ]
> ]UNIX System V/386 Release 3, Block and Character Interface, Device Driver
> ]Reference Manual, Select Code 307-192.

Hmmm... I own a Select Code 307-192 but mine is called "UNIX System V,
Release 3 Block and Character Interface (BCI) Driver Reference Manual".
It is basicly manual pages for kernal routines and kernal data structures.
It's a large book -- 8.5 by 11 inch pages with several hundred pages.

It has a companion volume which you didn't mention.  The companion is
"UNIX System V, Release 3 Block and Character Interface (BCI) Driver
Development Guide".  This tome is twice the size of its companion.
Select Code 307-191.  Chapters:
	1 About this Document
	2 Intro to UNIX Device Drivers
	3 Drivers in the UNIX Operating System
	4 Header Files and Data Structures
	5 System and Driver Initialization
	6 Input/Output Operations
	7 Drivers in the TTY Subsystem
	8 Input/Output Control (ioctl)
	9 Synchronizing Hardware and Software Events
	10 Interrupt Routines
	11 Error Reporting
	12 Installation
	13 Testing and Debugging the Driver
	14 Performance Considerations
	15 Porting the Driver
	16 Packaging the Driver
	Appendix A Equipped Device Table (EDT)
	Appendix B Writing 3B2 Computer Diagnostics Files
	Appendix C Sample Character Driver
	Appendix D Sample Block Driver
	Glossary
	Index

Neither book is specific to the 386.  Both are specific to the 3B line from
ATT.  Quoting without permission from 307-192:

	...Although most of the information in this book is applicable to
	any UNIX System V computer, the manual contains examples and
	information specifically for the following computers and
	releases:
		* WE 321 Single-Board-Computer, UNIX System V/VME Release 3.1
		* AT&T 3B2/300 Computer, UNIX System V Release 3.1
		etc.

No mention of 386.  Still, I strongly recommend both volumes.

> ]
> ]Even though this is targeted at UNIX 3.2, 
In my books, it's 3.1 and 3.1.1 actually.

> ]UNIX System V/386 Release 3.2 Integrated Software Development Guide (ISDG)
> Does the Integrated Software Design Guide exist 

It's not in my catalog. But I do have an old catalog.  No 3.2 stuff.

> Thanks alot,
> A. Lester Buck		...!uhnix1!moray!siswat!buck

Paul Hite   PRC Realty Systems  McLean,Va   uunet!prcrs!paul    (703) 556-2243
                      DOS is a four letter word!

dar@belltec.UUCP (Dimitri Rotow) (01/03/89)

In article <363@siswat.UUCP>, buck@siswat.UUCP (A. Lester Buck) writes:
> A while ago, Dimitri Rotow of Bell Technologies posted the following:
> 

[Repeat of my earlier posting deleted except for 800 number...]

> ]To order AT&T documents, call their Customer Information Center at
> ]800-432-6600.  They take VISA and are very responsive.   The material
> 
> I finally got around to try ordering these two manuals and called the
> 800 number.  The Device Driver Reference Manual was easy with the
> select code, but they could not find the ISDG from the above title
> (and missing a select code).  I called Bell Tech for a select code,
> but they couldn't find one on their documentation.  (They suggested
> I buy their version of V3.2...)  I sent email to Dimitri Rotow but
> never got a reply back.
> 
> Does the Integrated Software Design Guide exist as an AT&T publication
> available for sale separately?  Does anyone know a select code
> to use for this ISDG?
> 
> A. Lester Buck		...!uhnix1!moray!siswat!buck


You know, I've gotten about 150 mail messages and over two dozen phone
calls on this issue.  Why is it that people expect us to function as 
an 800 number information operator?

AT&T references its documents in many ways.  If you can't get to the 
ISDG by that title only, try by asking for the documentation for their
UNIX Release 3.2 package.  If that mystifies the operator, work with 
her/him a little.  Try "simultask" for WGS 6386 or a variety of other
AT&T nomenclature items.  We've never had any problems ordering ISDG
by calling the 800 numbers.  For the record, the listed select code
in *some* AT&T documents for the ISDG is 307-072.  This is no 
guarantee that the CIS will have that select code in their computer.

If you can't figure out how to get this document from AT&T, call AT&T.
If you want to buy it from us, we can't sell it to you (since it is
UNIX licensed material and AT&T has given Prentice Hall an exclusive
on selling UNIX manuals outside of an association with a UNIX software
license) *unless* you also buy 3.2.  Their rules, not ours.


- dimitri rotow