home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / misc / volume33 / prtscrn2 / patch01 < prev    next >
Encoding:
Text File  |  1992-11-01  |  9.8 KB  |  273 lines
  1. Newsgroups: comp.sources.misc
  2. From: Chip Rosenthal <chip@chinacat.unicom.com>
  3. Subject:  v33i029:  prtscrn2 - screen dump utility for SCO UNIX/XENIX, Patch01
  4. Message-ID: <1992Nov1.225933.26965@sparky.imd.sterling.com>
  5. X-Md4-Signature: b6100260447f85806d1714fc50d54ded
  6. Date: Sun, 1 Nov 1992 22:59:33 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: Chip Rosenthal <chip@chinacat.unicom.com>
  10. Posting-number: Volume 33, Issue 29
  11. Archive-name: prtscrn2/patch01
  12. Environment: SCO
  13. Patch-To: prtscrn2: Volume 30, Issue 76
  14.  
  15. `Prtscrn' grabs the contents of an SCO Unix or Xenix console screen
  16. and sends them to stdout -- for saving to a file, printing, etc.
  17.  
  18. This patch is of interest primarly to SCO Xenix 2.3.3 users.  This
  19. patch does not add new functionality or bug fixes.  It merely addresses
  20. a porting issue and cleans up the documentation a bit.  Please see
  21. the README file for additional details.
  22.  
  23. Index: patchlevel
  24. *** /dev/null    Fri Oct 23 19:50:30 1992
  25. --- patchlevel    Fri Oct 23 19:57:46 1992
  26. ***************
  27. *** 0 ****
  28. --- 1,9 ----
  29. + 
  30. + Patchlevel 1    Add CONS_GETINFO declarations for XENIX 2.3.3.  Cleanup
  31. +         descriptive text.  Update README with information on
  32. +         compatibility with various XENIX releases.
  33. + 
  34. + Patchlevel 0    Initial release.  (comp.sources.misc vol 30, issue 76)
  35. + 
  36. + @(#) patchlevel 1.2 92/10/23 19:57:37
  37. + 
  38. Index: README
  39. *** Distrib/README    Fri Oct 23 19:43:01 1992
  40. --- README    Fri Oct 23 19:44:01 1992
  41. ***************
  42. *** 1,16 ****
  43. ! @(#) README 1.3 92/06/16 21:17:03
  44.   
  45. ! `prtscrn' grabs the contents of a console MultiScreen(tm) on SCO
  46. ! UNIX and XENIX systems.
  47.   
  48. ! To dump the contents of /dev/tty01 to a file, you'd run:
  49.   
  50.       prtscrn -1 >filename
  51.   
  52. ! To dump the contents of the current screen, simply run:
  53.   
  54.       prtscrn >filename
  55.   
  56.   An earlier version of the `prtscrn' program was published in
  57.   comp.sources.misc volume 22.  This version has many improvements.
  58.   
  59. --- 1,22 ----
  60. ! @(#) README 1.5 92/10/23 19:42:43
  61.   
  62. ! `prtscrn' grabs the contents of a console MultiScreen(tm) on SCO Unix
  63. ! and Xenix systems.  This program has been tested on SCO Unix release
  64. ! 3.2v2.0 and SCO Xenix release 2.3.4.  This program will NOT work with
  65. ! SCO Xenix/286 or old releases of SCO Xenix -- see below for more info.
  66.   
  67. ! To dump the contents of /dev/tty01 to a file, you'd run
  68.   
  69.       prtscrn -1 >filename
  70.   
  71. ! To dump the contents of the current screen, simply run
  72.   
  73.       prtscrn >filename
  74.   
  75. + To print the current screen, say
  76. + 
  77. +     prtscrn | lp
  78. + 
  79.   An earlier version of the `prtscrn' program was published in
  80.   comp.sources.misc volume 22.  This version has many improvements.
  81.   
  82. ***************
  83. *** 18,24 ****
  84.         the kernel or system memory, and thus no longer needs to be
  85.         installed with privileges.
  86.   
  87. !     - This version is portable between SCO XENIX and SCO UNIX.  Not
  88.         only are there no longer special ifdef's, but also a binary
  89.         compiled on one of these will work on the other.
  90.   
  91. --- 24,30 ----
  92.         the kernel or system memory, and thus no longer needs to be
  93.         installed with privileges.
  94.   
  95. !     - This version is portable between SCO Xenix and SCO Unix.  Not
  96.         only are there no longer special ifdef's, but also a binary
  97.         compiled on one of these will work on the other.
  98.   
  99. ***************
  100. *** 33,38 ****
  101. --- 39,68 ----
  102.   
  103.       - I've coded this version to hopefully support systems with multiple
  104.         display adapters, but I haven't tested it.
  105. + 
  106. + 
  107. + NOTE TO SCO XENIX USERS:
  108. + 
  109. +     This utility uses a operation called CONS_GETINFO to obtain required
  110. +     information on the console.  As far as I know, no releases of SCO
  111. +     Xenix/286 support this function.  This operation is fully supported
  112. +     under Xenix/386 2.3.4, and is not supported at all under Xenix/386
  113. +     2.3.2 and earlier.  It is supported under *some* releases of 2.3.3.
  114. + 
  115. +     There were several different releases of SCO Xenix which called
  116. +     themselves 2.3.3.  The later ones include the required console
  117. +     driver updates.  If you are running 2.3.3 by way of update UFN
  118. +     (SLS xnx296) then this utility will work.  If you are running
  119. +     2.3.3 by way of update UFJ (included with older versions of VP/ix)
  120. +     then this utility will *not* run.  I do not know offhand whether
  121. +     2.3.3 by way of update UFM (SLS xnx155B) has the new console driver
  122. +     or not.
  123. + 
  124. +     If you are stuck with a version of Xenix which will not support
  125. +     this utility, there is an earlier version of `prtscrn' in the
  126. +     comp.sources.misc archives (volume 22, issue 27) you may use.
  127. +     That older release isn't as good as this one, but it is functional.
  128. + 
  129.   
  130.   Chip Rosenthal
  131.   <chip@chinacat.Unicom.COM>
  132. Index: prtscrn.c
  133. *** Distrib/prtscrn.c    Fri Oct 23 19:43:01 1992
  134. --- prtscrn.c    Fri Oct 23 19:43:50 1992
  135. ***************
  136. *** 1,38 ****
  137.   #ifndef lint
  138. ! static char SCCSID[] = "@(#) prtscrn.c 1.6 92/06/17 01:09:54";
  139.   #endif
  140.   
  141.   /*
  142.    * prtscrn - SCO UNIX/XENIX console screen dump utility.
  143.    *
  144. !  * This works by attaching to the display adapter memory and extracting
  145. !  * the out the characters and dumping them to stdout.  In order to
  146. !  * do this we need to make the selected screen active so that it's
  147. !  * contents are loaded into display memory.  What gets tricky is that
  148. !  * we need to figure out what screen is on the adapter when we begin
  149. !  * so we can put that screen back when we are done.
  150.    *
  151. !  * One way to find out what screen is active is to open up the
  152. !  * display adapter (e.g. "/dev/vga") and do a CONS_GETINFO ioctl()
  153. !  * upon it.  However, we first need to know what kind of display
  154. !  * adapter is being used.  If we are dumping a specific screen
  155. !  * (i.e. a screen number was given on the command line) then we
  156. !  * will open up that tty, and do a CONS_CURRENT ioctl() upon it
  157. !  * to get the adapter type.  If we are dumping the current screen
  158. !  * (i.e.  no screen number given on the command line) then we
  159. !  * will do the CONS_CURRENT ioctl() upon "/dev/tty".  Note that
  160. !  * a side effect of this is that we should be able to make a dump
  161. !  * of a screen from any terminal on the system (permissions
  162. !  * willing), and further this should work on a system with multiple
  163. !  * display adapters.
  164.    *
  165. -  * Security is enforced by permissions on the console tty.  That is,
  166. -  * if you try to dump screen 2, then you need to have read/write
  167. -  * permissions to /dev/tty02.  This utility assumes that the user
  168. -  * has read permissions on the adapter device, e.g. /dev/vga.  The
  169. -  * default is to grant world read/write for these devices.  I'm not
  170. -  * sure that is wise, but we assume that's the way things are.
  171. -  *
  172.    * Edit at tabstops=4.
  173.    *
  174.    * Chip Rosenthal
  175. --- 1,30 ----
  176.   #ifndef lint
  177. ! static char SCCSID[] = "@(#) prtscrn.c 1.8 92/10/23 19:42:44";
  178.   #endif
  179.   
  180.   /*
  181.    * prtscrn - SCO UNIX/XENIX console screen dump utility.
  182.    *
  183. !  * This utility works by attaching to the display adaptor memory,
  184. !  * extracting the characters from memory, and dumping them to
  185. !  * stdout.  This means that we need to activate the selected
  186. !  * screen so that its contents are loaded into display memory.
  187. !  * We also need to figure out which screen was active on the
  188. !  * display at startup so that we can put that screen back on the
  189. !  * display when done.
  190.    *
  191. !  * There are some gyrations we need to go through in order to
  192. !  * support various adapter types -- and even systems with multiple
  193. !  * display adapters.  First, we need to open the screen we want
  194. !  * to dump (e.g.  "/dev/tty02") and do a CONS_CURRENT ioctl()
  195. !  * upon it.  This will tell us the sort of adapter this screen
  196. !  * is upon.  Then we can open up the adapter device (e.g.
  197. !  * "/dev/vga") and manipulate the screen selection and access
  198. !  * the display memory.  This utility needs read/write access to
  199. !  * the screen device and read access to the display adapter.
  200. !  * This can be used to prevent unauthorized people from dumping
  201. !  * another person's display.
  202.    *
  203.    * Edit at tabstops=4.
  204.    *
  205.    * Chip Rosenthal
  206. ***************
  207. *** 53,58 ****
  208. --- 45,71 ----
  209.   #include <sys/vtkd.h>
  210.   
  211.   #define USAGE    "usage: %s [-screen_num]\n"
  212. + 
  213. + /*
  214. +  * Although the CONS_GETINFO operation was added in XENIX 2.3.3, the
  215. +  * header files were not updated until 2.3.4.  We need to provide the
  216. +  * required declarations for 2.3.3 systems.
  217. +  */
  218. + #ifndef CONS_GETINFO /*{*/
  219. + #    define CONS_GETINFO    (CONSIOC|73)
  220. +     struct vid_info
  221. +     {
  222. +         short    size;                /* must be first field            */
  223. +         short    m_num;                /* multiscreen number, 0 based    */
  224. +         ushort    mv_row, mv_col;        /* cursor position                */
  225. +         ushort    mv_rsz, mv_csz;        /* text screen size                */
  226. +         struct colors    mv_norm,    /* normal attributes            */
  227. +                 mv_rev,                /* reverse video attributes        */
  228. +                 mv_grfc;            /* graphic character attributes    */
  229. +         uchar_t mv_ovscan;            /* border color                    */
  230. +         uchar_t mk_keylock;            /* caps/num/scroll lock            */
  231. +     };
  232. + #endif /*}!CONS_GETINFO*/
  233.   
  234.   char *Progname;
  235.   
  236. Index: prtscrn.1
  237. *** Distrib/prtscrn.1    Fri Oct 23 19:43:01 1992
  238. --- prtscrn.1    Fri Oct 23 19:44:01 1992
  239. ***************
  240. *** 1,4 ****
  241. ! .\" @(#) prtscrn.1 1.5 92/06/16 21:17:04
  242.   .TH PRTSCRN 1L
  243.   .SH NAME
  244.   prtscrn \- Print contents of a console multiscreen.
  245. --- 1,4 ----
  246. ! .\" @(#) prtscrn.1 1.6 92/10/23 19:42:44
  247.   .TH PRTSCRN 1L
  248.   .SH NAME
  249.   prtscrn \- Print contents of a console multiscreen.
  250. ***************
  251. *** 20,25 ****
  252. --- 20,29 ----
  253.   Never tested with multiple display adapters.
  254.   Only supports text mode operation.
  255.   Although it will handle eight-bit characters, it won't do attributes.
  256. + .P
  257. + This utility is supported on SCO Unix, SCO Xenix 2.3.4, and SCO Xenix
  258. + 2.3.3 by way of update UFN (SLS xnx296).  It is not supported on
  259. + Xenix/286 or older releases of Xenix/386.
  260.   .SH AUTHOR
  261.   Chip Rosenthal
  262.   .br
  263.  
  264. <end of patch1 to prtscrn2>
  265.  
  266. -- 
  267. Chip Rosenthal  512-482-8260 | I got the blues so bad one time
  268. Unicom Systems Development   | it put my face in a permanent frown.
  269. <chip@chinacat.Unicom.COM>   |   - Taj Mahal
  270.  
  271.  
  272. exit 0 # Just in case...
  273.