home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / macintosh / machten-faq < prev    next >
Internet Message Format  |  1998-06-09  |  99KB

  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.kodak.com!news-nysernet-5.sprintlink.net!news-dc-2.sprintlink.net!news-east.sprintlink.net!news-peer.sprintlink.net!news.sprintlink.net!newsfeed.direct.ca!peerfeed.ncal.verio.net!nntp.ni.net!not-for-mail
  2. From: jjulca@tenon.com
  3. Newsgroups: comp.unix.machten,comp.answers,news.answers
  4. Subject: [comp.unix.machten] MachTen & CodeBuilder FAQ
  5. Followup-To: comp.unix.machten
  6. Date: 8 Jun 1998 17:33:16 GMT
  7. Organization: Network Intensive
  8. Lines: 2122
  9. Approved: news-answers-request@MIT.EDU
  10. Expires: 01 Jul 1998 00:00:00 -0800
  11. Message-ID: <6lh78s$54f$1@nnrp1.ni.net>
  12. NNTP-Posting-Host: athena.tenon.com
  13. Summary: This is Tenon Intersystems' FAQ for MachTen and CodeBuilder.
  14. Xref: senator-bedfellow.mit.edu comp.unix.machten:4996 comp.answers:31647 news.answers:132062
  15.  
  16. Archive-name: macintosh/machten-faq
  17. Posting-Frequency: monthly
  18. Last-modified: 1998/05/19
  19. URL: http://www.tenon.com/support/machten.faq.shtml
  20. Copyright: (c) 1998, Tenon Intersystems
  21. Maintainer: Jaime Julca <jjulca@tenon.com>
  22.  
  23. ----------------------------------------------------------------------------
  24.  
  25.                           MachTen & CodeBuilder FAQ
  26.  
  27.                                  MachTen 4.1
  28.  
  29.                               CodeBuilder 1.0.1
  30.  
  31.                                 Last Updated:
  32.                                  19 May 1998
  33.  
  34. ----------------------------------------------------------------------------
  35. This collection of frequently asked questions (FAQ) provides brief answers
  36. to many common questions about Tenon's MachTen and CodeBuilder software.
  37. Please check here for answers before posting a question to the MachTen
  38. newsgroup (comp.unix.machten) or before sending email to support@tenon.com.
  39. ----------------------------------------------------------------------------
  40.  
  41. A. General Questions
  42. general description of MachTen and CodeBuilder; versions; platforms
  43. supported
  44.  
  45. B. Communications
  46. interoperability and internetworking
  47.  
  48. C. Software Development
  49. tools and porting techniques
  50.  
  51. D. The X Window System
  52. understanding and using X
  53.  
  54. E. File Handling Management
  55. Macintosh file system vs. a UNIX file system
  56.  
  57. F. Peripherals and Devices
  58. third-party devices and compatibility issues
  59.  
  60. G. Technical MachTen
  61. common technical support questions
  62.  
  63. We try to make as much information as possible available through our web
  64. site at http://www.tenon.com. If you have trouble finding the information
  65. you need there, please let us know.
  66.  
  67. ----------------------------------------------------------------------------
  68.  
  69. A. General Questions:
  70.  
  71. A1. What is MachTen?
  72. A2. What is CodeBuilder?
  73. A3. What is the difference between Power MachTen and CodeBuilder?
  74. A4. Why did Tenon develop MachTen?
  75. A5. What are the main reasons for marriage of UNIX and Macintosh?
  76. A6. How will Apple's acquistion of NeXT affect Tenon?
  77. A7. What are some of the typical applications for MachTen?
  78. A8. Is there anything that MachTen won't do that another machine running BSD
  79. UNIX can do?
  80. A9. Are there any other UNIX packages available for Macs and Power Macs?
  81. A10. How can MachTen be considered a real UNIX operating system when it is
  82. implemented on top of MacOS?
  83. A11. What models of Macintosh does MachTen run on?
  84. A12. What models of Macintosh does CodeBuilder run on?
  85. A13. What add-on hardware is supported?
  86. A14. What are the differences between Professional MachTen and Power
  87. MachTen?
  88. A15. How do I decide what version of MachTen I need?
  89. A16. Is it possible to upgrade from Professional MachTen to Power MachTen?
  90. A17. What are MachTen's memory and disk requirements?
  91. A18. Does MachTen support virtual memory?
  92. A19. Is there any way I can have MachTen start up every time my Mac boots?
  93. A20. Does the "xxx" software package run on top of MachTen?
  94. A21. What commercial applications run on MachTen?
  95. A22. As UNIX is so file I/O intensive, what kind of performance can MachTen
  96. have if Apple's file system is so slow?
  97. A23. Can more than one user access the MachTen host system?
  98. A24. Can users without a UNIX account use the Mac solely as a Mac?
  99. A25. What is the visual appearance of MachTen/CodeBuilder?
  100. A26. Can you start Mac applications both under Finder and under the UNIX
  101. shell?
  102. A27. What Mac applications run on MachTen?
  103. A28. Can I get a demo of MachTen?
  104. A29. Does Tenon offer educational discounts?
  105. A30. Is MachTen/CodeBuilder compatible with MacOS 8?
  106.  
  107. A1. What is MachTen?
  108.  
  109. MachTen is a Berkeley UNIX operating system with a Carnegie-Mellon Mach
  110. kernel. It runs as an application on the Macintosh Operating System (MacOS).
  111. The MachTen UNIX kernel supports a standard UNIX applications environment
  112. which in turn supports hundreds of standard UNIX applications. The UNIX
  113. operating system runs in concert with the Macintosh operating system. When
  114. MachTen is running, you still have access to the Macintosh Finder desktop
  115. and Macintosh applications, such as a Macintosh spreadsheet or desk
  116. accessory application.
  117.  
  118. Even though MachTen gives the appearance of being just another Macintosh
  119. application, its operation is more like that of a co-resident operating
  120. system. MachTen and MacOS share the processor -- when MachTen has control,
  121. it pre-emptively multitasks the UNIX applications; when MacOS has control,
  122. it runs the Mac applications using its cooperative sharing.
  123.  
  124. Since MachTen runs on top of MacOS, there is no need to partition the hard
  125. drive or to install separate MachTen-specific device drivers. MachTen maps
  126. the UNIX file system to the MacOS file system and uses the MacOS device
  127. drivers. This means that there is a single, consistent file system and that
  128. third party devices, such as network controller boards, automatically run
  129. with MachTen.
  130.  
  131. In addition, Power MachTen has its own native fast file system (implemented
  132. within a single Macintosh file) that gives UNIX operations a significant
  133. performance boost.
  134.  
  135. MachTen is a full-fledged operating system that, for portability reasons,
  136. uses as much of the device driver software that's available in the
  137. Macintosh. Where necessary, it will operate directly with the hardware.
  138.  
  139. A2. What is CodeBuilder?
  140.  
  141. CodeBuilder is a powerful and unique Macintosh software development tool for
  142. porting existing applications or developing new, advanced applications on
  143. Power Macs and Power Mac clones.
  144.  
  145. CodeBuilder is a Power Macintosh application that includes a complete suite
  146. of C, C++, Objective-C, Java, Ada, and Fortran development tools.
  147. CodeBuilder can be used in combination with standard Macintosh editors and
  148. compilers to develop Macintosh applications, X applications, and NeXT/UNIX
  149. applications.
  150.  
  151. CodeBuilder gives developers the ability to create an application with a
  152. single source base not only for Power Macs under a native Apple operating
  153. system, but also for Silicon Graphics, SUN, NeXT, or HP environments.
  154. CodeBuilder gives Apple developers the freedom to take advantage of
  155. time-tested UNIX development tools and to explore Objective-C and Ada,
  156. without giving up the features of their favorite Macintosh editors and
  157. compilers. Because CodeBuilder uses standard Macintosh binary formats, you
  158. can use Macintosh debuggers and even combine Macintosh compiler output with
  159. CodeBuilder's UNIX compiler output. CodeBuilder is a new standard in PowerPC
  160. software development.
  161.  
  162. A3. What is the difference between Power MachTen and CodeBuilder?
  163.  
  164. MachTen is a full-fledged UNIX system that runs over the MacOS. CodeBuilder
  165. has a MachTen kernel and many of the UNIX features, but lacks MachTen's
  166. networking. CodeBuilder includes many tools available to MachTen owners only
  167. on the Ported Apps Vol. 2 CD.
  168.  
  169. A4. Why did Tenon develop MachTen?
  170.  
  171. Tenon's goal was to "unlock" the processing power of personal computers and
  172. put them on an equal footing with workstations, minis, and mainframes.
  173.  
  174. On one hand, MachTen brings UNIX applications and technology to the
  175. Macintosh desktop; on the other hand, it provides a vehicle for Macintosh
  176. users to access those larger functional capabilities and communications
  177. protocols that are fundamentally developed by the workstation community.
  178. These industry standard tools can be brought to the desktop where Macintosh
  179. applications are able to take advantage of them. It is a dual-directional
  180. approach.
  181.  
  182. MachTen makes client/server computing available for everyone by lowering the
  183. price point of this capability by an order of magnitude. When Apple built
  184. the Macintosh, they called it a computer for "the rest of us". MachTen is
  185. UNIX for "the rest of us".
  186.  
  187. A5. What are the main reasons for marriage of UNIX and Macintosh?
  188.  
  189. The Macintosh is the most user-friendly computer. Windows is trying to
  190. achieve the friendliness of the Mac. UNIX is the richest, most popular
  191. software development environment, and is becoming a universally accepted
  192. standard for distributed computing. It has an abundant set of communications
  193. protocols and file sharing software - Telnet, r-series, email, file
  194. transfer, NFS client and server. MachTen makes that plentiful environment
  195. available on a Macintosh.
  196.  
  197. The combination of Macintosh and UNIX has been enthusiastically embraced by
  198. both Macintosh and UNIX lovers.
  199.  
  200. A6. How will Apple's acquistion of NeXT affect Tenon?
  201.  
  202. Apple's acquistion of NeXT Corporation validates Tenon's choice of the
  203. Carnegie Mellon Mach kernel coupled with a Berkeley UNIX as a way to extend
  204. and enhance MacOS. Tenon has been shipping the exact same variant of UNIX
  205. chosen by Steve Jobs for the foundation of its MachTen UNIX that runs on
  206. every single Macintosh and Power Mac.
  207.  
  208. We think that MachTen could accelerate Apple's porting efforts, since our
  209. software has already been made extremely portable by removing the UNIX/Mach
  210. hardware dependencies. Interfacing our software to the Copland Nu kernel and
  211. then adding the advanced NeXT tools on top may be the fastest way for Apple
  212. to get NeXT OS on Power Macs. Tenon's development organization includes the
  213. world's largest collection of engineers with Mach/MacOS/PPC experience.
  214.  
  215. Our UNIX software development environment generates MacOS (PEF) binaries
  216. from UNIX sources. In addition to C and C++ compilers for the 68K and
  217. PowerMac, our development environment includes essential UNIX standard
  218. tools, such as make, lex, and yacc. We have used these tools to port
  219. millions of lines of UNIX system source and hundreds of UNIX application
  220. programs to both 68K Macs and Power Macs. The advanced NeXT development
  221. tools (and even applications, such as WebObjects) could easily be ported to
  222. MachTen using these tools. This done, MachTen could give developers an early
  223. platform for porting applications.
  224.  
  225. By incorporating the 68K version of our software into their strategy, Apple
  226. could make the integrated NeXT system backward compatible to all M68K
  227. Macintoshes. By doing this, they might actually be able to bring the 68K
  228. port out ahead of the PowerMac port.
  229.  
  230. Tenon's software already supports AfterStep (a NeXT-like X Window manager)
  231. and soon will support Objective C. Portions of GNUStep (the FSF version of
  232. NeXTStep) have been ported to MachTen.
  233.  
  234. A7. What are some of the typical applications for MachTen?
  235.  
  236. MachTen opens up new markets for Apple to offer Macs and Power Macs as
  237. inexpensive UNIX and X software development platforms. It also lets users
  238. integrate every Macintosh in the environment with all the other processors
  239. in the enterprise -- it doesn't even have to be UNIX-based -- anything
  240. TCP/IP-based can interoperate with a Macintosh. On the one hand, MachTen is
  241. an inexpensive UNIX development environment; on the other hand, it is an
  242. excellent connectivity tool for the Macintosh. MachTen can turn a Macintosh
  243. into a complete Internet server or a high-performance X terminal.
  244.  
  245. A8. Is there anything that MachTen won't do that another machine running BSD
  246. UNIX can do?
  247.  
  248. MachTen is a fully functional BSD system. Tenon has added a few
  249. MachTen-specific utilities; e.g.: it can change UNIX text into text
  250. recognizable by Macintosh applications and can cope with Apple Single/Double
  251. file formats. In addition, a Macintosh-style MachTen Control Panel lets you
  252. easily modify networking addresses and other system variables that would
  253. ordinarily require editing UNIX configuration files. So, in some sense, it
  254. is a friendlier UNIX. But, by and large, there are no surprises. MachTen is
  255. exactly what you would expect to find on any Berkeley UNIX system.
  256.  
  257. A9. Are there any other UNIX packages available for Macs and Power Macs?
  258.  
  259. Apple developed a commercial UNIX (A/UX) that ran on a subset of Macs. Apple
  260. no longer supports or sells A/UX, which was an older version of UNIX --
  261. SystemV, version 2 -- and was expensive in terms of memory and required disk
  262. space. MachTen is a more compact UNIX that can run on all Macs and all Power
  263. Macs. A/UX was implemented on the bare Macintosh hardware, which required
  264. Apple to port A/UX to new platforms on a machine-by-machine basis. Unlike
  265. A/UX, MachTen sits on top of the MacOS, which means that you don't need
  266. special device drivers and you don't have to partition your disk.
  267.  
  268. In 1996, Apple began distributing MkLinux. MkLinux is a public domain
  269. version of Linux that has been ported to a few Power Mac platforms (Nu-bus
  270. based Power Macs). MkLinux, much like A/UX, runs on the bare Power Mac
  271. hardware. Users must use MkLinux-specific device drivers and cannot run Mac
  272. applications while MkLinux is running. The current version of MkLinux is
  273. Developer Release 2.1. It is our understanding that Apple is no longer
  274. supporting new MkLinux development.
  275.  
  276. A10. How can MachTen be considered a real UNIX operating system when it is
  277. implemented on top of MacOS?
  278.  
  279. Even though MachTen gives the appearance of being just another Macintosh
  280. application, MachTen and MacOS operate very much like co-resident operating
  281. systems, sharing the processor. When MachTen has control, it pre-emptively
  282. multitasks UNIX applications; when MacOS has control, it runs the Macintosh
  283. applications using its cooperative sharing. There is a slide bar Control
  284. Panel that lets you prioritize UNIX processing over Macintosh processing.
  285.  
  286. A11. What models of Macintosh does MachTen run on?
  287.  
  288. MachTen is designed to run on all modern Macs, from the Classic to the
  289. Quadra AV machines, all PowerBooks and Duos, and all Power Macs, including
  290. the lastest G3 desktops, tower, and PowerBook..
  291.  
  292. A12. What models of Macintosh does CodeBuilder run on?
  293.  
  294. CodeBuilder is designed to run on all Power Macs, Power Mac clones, and
  295. PowerPC PowerBooks, including the lastest G3 desktops, tower, and PowerBook.
  296.  
  297. A13. What add-on hardware is supported?
  298.  
  299. Because MachTen sits on top of the Macintosh file system and interoperates
  300. with the Finder, all add-on hardware should work under MachTen. MachTen has
  301. been used with Syquest drives, Bernoulli drives, Zip drives, accelerators,
  302. multiport serial cards, ethernet cards (NuBus, SCSI, PCI) and video cards,
  303. among others. In cases where MachTen takes control of the hardware (e.g., to
  304. implement virtual memory), there could be incompatibilities.
  305.  
  306. A14. What are the differences between Professional MachTen and Power
  307. MachTen?
  308.  
  309. Both Professional MachTen and Power MachTen are complete UNIX operating
  310. systems with identical UNIX commands and utilities and identical UNIX
  311. communications that include an enhanced TCP protocol stack and UNIX file
  312. sharing and printer sharing. Professional MachTen is based on BSD 4.3
  313. Berkeley UNIX; Power MachTen is based on BSD Berkeley 4.4. Both Professional
  314. MachTen and Power MachTen include an X server and an X client execution and
  315. development environment.
  316.  
  317. Professional MachTen supports UNIX/Mach virtual memory. In other words,
  318. Professional MachTen completely takes over the memory management functions
  319. from MacOS to page both UNIX and Macintosh applications from memory to disk.
  320. Since MachTen's paging algorithms are more sophisticated than those of
  321. MacOS, Professional MachTen's VM gives improved performance under low memory
  322. conditions. In addition, Professional MachTen runs UNIX applications in
  323. protected memory space.
  324.  
  325. Power MachTen, the native Power PC version of MachTen, has all the features
  326. of Professional MachTen (except for protected and virtual memory), and all
  327. the features of MachTen X Window Software. In addition, Power MachTen has
  328. some unique features, such as support for shared memory, shared libraries,
  329. integrated Macintosh and UNIX development environment, and support for UNIX
  330. hard links.
  331.  
  332. A15. How do I decide what version of MachTen I need?
  333.  
  334. For PowerPC-based Macs (Power Macs), Power MachTen is your ONLY choice.
  335.  
  336. A16. Is it possible to upgrade from Professional MachTen to Power MachTen?
  337.  
  338. If you have continuous coverage under a MachTen Maintenance plan, you can
  339. always request Power PC native versions of MachTen instead of 68K versions.
  340. Without Maintenance, you can explicitly purchase a PPC upgrade.
  341.  
  342. A17. What are MachTen's memory and disk requirements?
  343.  
  344. MachTen is one of the most compact UNIX operating systems available. The
  345. MachTen 68K application itself consumes 2MB in memory. Since System 7 takes
  346. roughly 2MB RAM, you can see that you need more than 4MB RAM in order to
  347. have enough memory available for UNIX and Mac applications. A total of 8MB
  348. RAM is recommended for Professional MachTen, especially if you are doing
  349. software development or running X. The Power MachTen application consumes
  350. about 3MB RAM; a total of 16MB RAM is recommendedfor Power MachTen.
  351.  
  352. The hard disk requirements can vary from 15MB to 90MB, depending upon
  353. whether you install the development tools and the X Window software
  354. components of MachTen.
  355.  
  356. A18. Does MachTen support virtual memory?
  357.  
  358. On 68030 and 68040 machines, Professional MachTen takes over the memory
  359. management hardware to provide demand-paged virtual memory and memory
  360. protection.
  361.  
  362. Power MachTen does not yet support UNIX virtual memory nor memory
  363. protection. Tenon originally designed Power MachTen to take advantage of
  364. Copland's protected threads. Apple's next-generation OS quickly became a
  365. moving target. Talk of Copland eventually became talk of BeOS, and now with
  366. the NeXT acquisition, Rhapsody is on the horizon. At this time, Tenon does
  367. not plan to implement UNIX VM for Power MachTen. This could change depending
  368. on market demand.
  369.  
  370. Power MachTen can, of course, be used with MacOS VM or RAMDoubler.
  371.  
  372. A19. Is there any way I can have MachTen start up every time my Mac boots?
  373.  
  374. An alias to MachTen can be installed in the Startup Items folder in your
  375. System Folder. This will start MachTen every time your Mac boots. You can
  376. even run Power MachTen without the Finder.
  377.  
  378. MachTen can also be configured to boot instead of the Finder. This is most
  379. beneficial if a Macintosh is to be used fundamentally as a UNIX system and
  380. few, if any, desktop operations are needed. Running MachTen as the Finder
  381. saves precious RAM and processing resources. To maintain the Desktop, Finder
  382. must assume control of the system every few seconds in order to update
  383. folder file information, handle changes in the volume structure, and perform
  384. general bookkeeping for the Desktop. It is possible to run MachTen without
  385. Finder and, if needed, start the Finder from MachTen.
  386.  
  387. While this idea is interesting and has a certain academic quality to it (in
  388. that you are able to get the most possible from your Macintosh for your UNIX
  389. processing), it may only have appeal for more vigorous UNIX enthusiasts.
  390. This whole mechanism becomes much more interesting, however, if a Macintosh
  391. is to be used in an environment where access to the Macintosh desktop and
  392. its MachTen files need to be controlled. Running MachTen as the Finder
  393. forces every user to log in in the traditional UNIX manner. To configure
  394. your Macintosh to start MachTen instead of Finder upon power ON, please see
  395. the Tenon Technical Note, "MachTen as Finder".
  396.  
  397. A20. Does the "xxx" software package run on top of MachTen?
  398.  
  399. Most UNIX software packages can be ported to MachTen in a straightforward
  400. way. MachTen is a "vanilla" Berkeley system, with standard BSD libraries. To
  401. run MachTen on systems with small amounts of memory and without UNIX virtual
  402. memory, it is sometimes necessary to avoid large automatic variables by
  403. using malloc/free.
  404.  
  405. Hundreds of public domain applications have been ported to MachTen. For a
  406. list see http://www.tenon.com/products/machten/machten.apps.shtml.
  407.  
  408. A21. What commercial applications run on MachTen?
  409.  
  410. While hundreds of public domain applictions have been ported to MachTen,
  411. commercial vendors have been less enthusiastic. Initially vendors directed
  412. their attention toward A/UX. Not that A/UX no longer exists and Rhapsody is
  413. on the horizon, vendors may become more receptive. A port to MachTen would
  414. easily transition to Rhapsody.
  415.  
  416. A22. As UNIX is so file I/O intensive, what kind of performance can MachTen
  417. have if Apple's file system is so slow?
  418.  
  419. Having lots of memory and making sure that you have a fast hard disk and a
  420. fast software disk driver go a long way to ensuring good performance. Power
  421. MachTen ships with a native fast file system that gives a two to ten fold
  422. performance improvement. MachTen on Apple's new G3 machines is very fast.
  423.  
  424. A23. Can more than one user access the MachTen host system?
  425.  
  426. Yes. MachTen turns your Macintosh into a multitasking, multiuser
  427. environment.
  428.  
  429. A24. Can users without a UNIX account use the Mac solely as a Mac?
  430.  
  431. When MachTen is running, users have full access to Macintosh Finder and
  432. could simply run Macintosh programs. If MachTen is installed on a machine
  433. that will be shared by users who do not want to get involved with UNIX, they
  434. can simply use the Macintosh as a normal Mac, and not start up the MachTen
  435. application. On the other hand, if you always want to use MachTen, you can
  436. set your machine up so that the MachTen application comes on automatically
  437. when the Mac is powered up. Even with this setup, you can easily toggle from
  438. Mac applications to UNIX applications.
  439.  
  440. A25. What is the visual appearance of MachTen/CodeBuilder?
  441.  
  442. A Macintosh running MachTen or CodeBuilder appears simultaneously as a
  443. traditional UNIX system with multiple windows and a Berkeley command line
  444. interface, and as a traditional Macintosh system with a Finder interface. If
  445. you pull down the System application menu when MachTen or CodeBuilder is
  446. running, you can click on Finder, any Macintosh application, or
  447. MachTen/CodeBuilder. If X is running, you have an X desktop as well which
  448. you can customize with OpenLook, Motif and even AfterStep window managers.
  449. You can easily toggle back and forth between Finder, Mac apps, the UNIX
  450. desktop and the X desktop.
  451.  
  452. A26. Can you start Mac applications both under Finder and under the UNIX
  453. shell?
  454.  
  455. Yes. Under the UNIX shell you simply type (with * if necessary) the data
  456. file or application name, followed by a CR. Since most users continue to use
  457. Finder in combination with MachTen, the typical way to start a Mac app is by
  458. double-clicking. If you double-click a UNIX application when MachTen is
  459. already running, it will bring the MachTen application to the front;
  460. otherwise, it will start MachTen. Starting Mac apps in Power MachTen is a
  461. little more complicated to set up.
  462.  
  463. A27. What Mac applications run on MachTen?
  464.  
  465. Virtually all Macintosh applications work with MachTen. Occasionally an init
  466. or system extension will conflict with MachTen. Tenon's policy is to work
  467. toward eliminating incompatibilities if any are found.
  468.  
  469. When MacintoshTCP applications run with MachTen, they automatically use
  470. Tenon's TCP stack. If you want to run Macintosh Internet servers with
  471. MachTen, such as ftpd, you must make sure that the equivalent UNIX server
  472. daemon is not listening on the same port.
  473.  
  474. A28. Can I get a demo of MachTen?
  475.  
  476. Yes, demos are available. Contact sales@tenon.com for a copy.
  477.  
  478. A29. Does Tenon offer educational discounts?
  479.  
  480. Yes. Contact sales@tenon.com for more information.
  481.  
  482. A30. Is MachTen/CodeBuilder compatible with MacOS 8?
  483.  
  484. Power MachTen and CodeBuilder are compatible. MachTen 2.3 is not compatible,
  485. it will be replace with MachTen 2.4 which will be MacOS 8 compatible.
  486.  
  487. ----------------------------------------------------------------------------
  488.  
  489. B. Communications:
  490.  
  491. B1. Does MachTen interoperate with other versions of UNIX?
  492. B2. What are some of MachTen's communications features that allow the
  493. Macintosh to interoperate with other UNIX workstations?
  494. B3. What networking support does MachTen provide?
  495. B4. How do I configure MachTen for PPP?
  496. B5. Why use MachTen's TCP stack instead of MacTCP?
  497. B6. What are some of the features of Tenon's TCP stack that MacTCP lacks?
  498. B7. How will I run my MacTCP applications?
  499. B8. Is MachTen compatible with OpenTransport?
  500. B9. What Internet services does MachTen provide?
  501. B10. Do I need to have MachTen on each client machine?
  502. B11. How does MachTen's Web server compare to using WebStar?
  503. B12. If I create a Web server using MachTen, what tools are available for
  504. creating Web pages?
  505. B13. What tools are available for browsing a MachTen Web server?
  506.  
  507. B1. Does MachTen interoperate with other versions of UNIX?
  508.  
  509. Yes, MachTen can network with all standard TCP/IP implementations. For
  510. example, you can exchange tar-format floppies or mount NFS volumes with
  511. other UNIX machines such as SCO, A/UX, SUN, Solaris, HP, DEC, IBM 's AIX and
  512. NeXT, among others.
  513.  
  514. B2. What are some of MachTen's communications features that allow the
  515. Macintosh to interoperate with other UNIX workstations?
  516.  
  517. UNIX has a very rich set of communications protocols and file sharing
  518. software --Telnet, r-series, electronic mail, file transfer, and client and
  519. server NFS. MachTen provides this full complement of protocols for the
  520. Macintosh. With MachTen on your Macintosh, it is possible, for example, to
  521. store all Macintosh applications on the hard disk of a remote UNIX
  522. workstation and mount those applications on your Mac desktop with NFS. With
  523. MachTen, you can even mount Apple Share volumes on your Macintosh and then
  524. export those volumes using NFS.
  525.  
  526. MachTen has line printer spooling capabilities, so it can send printer
  527. output to the printer of a remote UNIX workstation. Any Macintosh on your
  528. LAN can send its printer output to a MachTen Macintosh, and MachTen can
  529. subsequently spool that output to any printer in your UNIX environment.
  530. Likewise, UNIX workstations can spool printer output to a MachTen Macintosh
  531. and have that output printed on a Macintosh LaserWriter.
  532.  
  533. B3. What networking support does MachTen provide?
  534.  
  535. MachTen includes a full TCP suite of protocols, including telnet, smtp and
  536. ftp. In addition, it includes all the standard UNIX communications, such as
  537. the Berkeley r-series and both client and server NFS. MachTen also includes
  538. domain name service (DNS), IP forwarding, and a built-in Web server that
  539. supports multihoming. MachTen works over LocalTalk, ethernet and TokenTalk,
  540. and can route between these networks.
  541.  
  542. For serial line connectivity, tip, cu, UUCP, SLIP and PPP are provided.
  543. MachTen makes use of the serial port portion of the Macintosh Communications
  544. Toolbox (CTB) if installed; otherwise, it controls the serial ports
  545. directly.
  546.  
  547. Using AppleTalk Remote, it is possible to dial into your AppleTalk
  548. environment and then use MachTen TCP communications across your AppleTalk
  549. networks.
  550.  
  551. B4. How do I configure MachTen for PPP?
  552.  
  553. We suggest reading:
  554.  
  555. Using PPP with MachTen
  556. Crafting An Internet Server With MachTen: A Step-By-Step Guide Part I by LT
  557. Richard Miller
  558. Crafting An Internet Server With MachTen: A Step-By-Step Guide - Part II
  559.  
  560. B5. Why use MachTen's TCP stack instead of MacTCP?
  561.  
  562. MachTen's TCP stack is from the Berkeley Reno sources and includes all the
  563. latest protocol improvements, such as Van Jacobsen's performance
  564. enhancements. This TCP stack is more robust, better performing and more
  565. fully-featured than MacTCP. MachTen provides interoperability with
  566. applications that rely on MacTCP, such as MacX and Eudora, by trapping
  567. MacTCP internals with Tenon's mactcp daemon. This means that MacTCP
  568. applications will automatically use MachTen's TCP stack when MachTen is
  569. running.
  570.  
  571. B6. What are some of the features of Tenon's TCP stack that MacTCP lacks?
  572.  
  573.    * Tenon's TCP stack supports an unlimited number of TCP connections;
  574.      MacTCP is effectively limited to 48 connections.
  575.    * Tenon's TCP stack supports multihoming. This lets you have multiple
  576.      network interfaces for redundancy, and lets you use your Macintosh as
  577.      an IP router.
  578.    * Tenon's TCP employs buffering and window management strategies and
  579.      packet retransmission algorithms that maximize both WAN and LAN
  580.      performance.
  581.    * Tenon's TCP includes management options to support statistics reporting
  582.      and reconfiguration without rebooting.
  583.    * Tenon's TCP allows multiple routing entries and dynamic routing; MacTCP
  584.      supports a single default route.
  585.    * Tenon's TCP supports multiple domain name servers, both local and
  586.      remote, and uses a standard 'hosts' file; MacTCP supports a single
  587.      remote name server and uses a non-standard 'hosts' file.
  588.    * Tenon's TCP supports multicasting. This allows MachTen to be used as a
  589.      CUSeeMe Reflector.
  590.    * Tenon's TCP stack supports IP aliasing, and enables multiple IP
  591.      addresses on a single network interface.
  592.  
  593. B7. How will I run my MacTCP applications?
  594.  
  595. If you start a MacTCP application (such as Eudora, Gopher, or Newswatcher)
  596. while MachTen is running, that application will automatically run using
  597. Tenon's TCP stack. If you attempt to run that application without MachTen
  598. running, the application will simply default to using MacTCP.
  599.  
  600. When you install MachTen, the MacTCP configuration parameters will
  601. automatically appear in the MachTen Networking Control Panel, so you don't
  602. have to re-enter your Internet addressing information. It is not necessary
  603. to deinstall MacTCP, since it will very compatibly coexist with MachTen.
  604.  
  605. B8. Is MachTen compatible with OpenTransport?
  606.  
  607. Power MachTen will run on machines with OpenTransport, such as the Power
  608. Macintosh 9500. Tenon's TCP stack is interfaced to the PPC native
  609. OpenTransport ethernet driver. OpenTransport and Tenon's TCP stack can run
  610. simultaneously, as long as they are on different physical interfaces. Since
  611. both Tenon's TCP stack and OpenTransport support MacTCP applications, you
  612. can configure your MacTCP apps to use either stack. As soon as the
  613. performance and feature set of OpenTransport are roughly equivalent to
  614. Tenon's TCP stack, Tenon will fully adopt OpenTransport.
  615.  
  616. B9. What Internet services does MachTen provide?
  617.  
  618. MachTen includes a complete TCP protocol stack (Telnet, FTP, SMTP, TCP, IP)
  619. and all the standard Internet services, such as domain name service (DNS),
  620. Post Office Protocol (POP) for a POP mail service, serial line IP (SLIP) and
  621. point-to-point protocol (PPP). MachTen also includes the NCSA httpd daemon
  622. with a pre-configured sample 'home' page.
  623.  
  624. A MachTen Macintosh can easily be set up as a full Internet host, configured
  625. as an IP forwarder, a domain name server, a POP mail server, and a Web
  626. server.
  627.  
  628. Power MachTen includes Apache 1.2.5 with special Macintosh-specific
  629. enhancements.
  630.  
  631. B10. Do I need to have MachTen on each client machine?
  632.  
  633. MachTen is a complete UNIX operating system, and, as such, includes both
  634. client and server components for each Internet service. Therefore, you could
  635. use MachTen on every Macintosh. Alternatively, for the client machines, you
  636. could simply use MacTCP with your favorite Macintosh client software, such
  637. as Eudora, Fetch or NCSA Telnet. MachTen can provide Internet services for
  638. any Mac or PC that supports TCP.
  639.  
  640. B11. How does MachTen's Web server compare to using WebStar?
  641.  
  642. MachTen includes the NCSA httpd daemon with multihomed extensions. Using
  643. MachTen as a Web server lets you set up multiple Web home pages, each with a
  644. unique URL of the type: http://www.companyname.com. WebStar (formerly
  645. MacHTTP) cannot support this style of multihomed Web pages.
  646.  
  647. In addition, Tenon's Web server is running in a pre-emptive, multitasking
  648. environment, which may be more suited than MacOS to supporting multiple,
  649. simultaneous World Wide Web accesses. Furthermore, if you run your Web
  650. service using Professional MachTen, the httpd daemon is running in protected
  651. memory space.
  652.  
  653. On the other hand, WebStar has some advantages, namely the ability to plug
  654. directly into a Macintosh supported database (such as the Butler database),
  655. and the ability to use Apple cgi scripts. For this reason, many customers
  656. are using WebStar and MachTen in combination.
  657.  
  658. B12. If I create a Web server using MachTen, what tools are available for
  659. creating Web pages?
  660.  
  661. Since MachTen is UNIX, any of the standard HyperText Markup Language (HTML)
  662. tools that are available under UNIX can be used. MachTen includes BBEdit
  663. 3.5, which has an HTML editor. In addition, you can use any Macintosh-based
  664. Web authoring tool, such as the new PageMill created by Ceneca and now
  665. available from Adobe.
  666.  
  667. B13. What tools are available for browsing a MachTen Web server?
  668.  
  669. You can use any browser (Mac, PC or UNIX based) from any machine to view a
  670. MachTen Web server. For server development, of course, you should have a
  671. local Macintosh browser, such as NCSA Mosaic (for MacOS or X), Netscape,
  672. etc. Mosaic for X has been ported to MachTen and can run on any Macintosh
  673. with MachTen X Window Software. Running any browser on a MachTen Macintosh
  674. will let you display in loopback mode any Web pages that you are developing.
  675. At the same time, you could also be 'surfing' the Internet and checking out
  676. potential Web links for the pages your are creating.
  677.  
  678. ----------------------------------------------------------------------------
  679.  
  680. C. Software Development:
  681.  
  682. C1. What software development tools are available with MachTen?
  683. C2. What porting issues will I encounter when recompiling programs under
  684. MachTen?
  685. C3. What version of MachTen is recommended for software development?
  686. C4. Will other Macs be able to run my applications without running
  687. CodeBuilder?
  688. C5. How much source code and documentation does CodeBuilder include?
  689. C6. Does MachTen support hard links?
  690.  
  691. C1. What software development tools are available with MachTen?
  692.  
  693. Professional MachTen includes C, C++, a source debugger, Mach C threads, and
  694. all the standard UNIX tools.
  695.  
  696. Power MachTen includes C, C++, g77 (gnu fortran 77), and a source debugger.
  697.  
  698. In addition, the following tools are included in all versions of MachTen:
  699.  
  700.    * Tools for Managing Software Development
  701.      RCS (Revision Control System)
  702.  
  703.    * Tools for Supporting Software Development
  704.      indent (formats C code)
  705.      lex (generates lexical analysis programs)
  706.      yacc ("yet another compiler compiler")
  707.  
  708.    * Tools for Building Libraries and Programs
  709.      gas (gnu assembler)
  710.      cc (gnu compiler director: forks the appropriate tools for compiling
  711.      and loading the objects specified)
  712.      ld (combines several object files into one)
  713.      make (executes a scripted set of commands)
  714.      ranlib (converts archives to a form that ld can load more rapidly)
  715.      cpp (gnu preprocessor)
  716.      nm (lists symbols in object files)
  717.  
  718.    * Libraries
  719.      libm.a, librpc.a, libcurses.a, plus the various program language
  720.      libraries
  721.  
  722.    * Tools for Building X Window Programs
  723.      imake (X platform independent make)
  724.      Core protocol X library
  725.      X Intrinsics toolkit library
  726.      Athena widget set
  727.      X security authorization library
  728.      X extensions library
  729.      Alternative input device exension library
  730.      Motif widget library
  731.      X Display Manager Control Protocol Library
  732.  
  733. C2. What porting issues will I encounter when recompiling programs under
  734. MachTen?
  735.  
  736. In general, since MachTen is a pure BSD UNIX, porting applications is
  737. relatively straightforward. However, in real-memory MachTen systems, such as
  738. Power MachTen, some porting issues can arise. Without protected memory, a
  739. bad pointer can bring down your entire machine. Additionally, it may become
  740. necessary, during the execution of a process, to grow the size of a segment
  741. to accomodate a larger stack. This is not a problem on a virtual memory
  742. system such as Professional MachTen. However, with Power MachTen (before VM
  743. is supported), you may need to make certain accommodations. See section
  744. 10.13 in the Power MachTen User's Guide for more inforomation.
  745.  
  746. C3. What version of MachTen is recommended for software development?
  747.  
  748. Because Professional MachTen supports virtual memory and protected memory,
  749. it is the recommended version for software development. Power MachTen, on
  750. the other hand, has some unique software development capabilities. Since
  751. Power MachTen's compilers generate the same binary PEF formats as
  752. Metrowerks, Symantec, and MPW, Power MachTen can develop pure Macintosh
  753. applications, or even combine Macintosh and UNIX software development tools
  754. to generate hybrid applications. Furthermore, Power MachTen is the only
  755. version that includes a Fortran compiler.
  756.  
  757. C4. Will other Macs be able to run my applications without running
  758. CodeBuilder?
  759.  
  760. Of course. Distribution format is completely up to the developer.
  761. CodeBuilder can create either Mac standalone or UNIX-based applications and
  762. includes examples of both types.
  763.  
  764. C5. How much source code and documentation does CodeBuilder include?
  765.  
  766. About 400 MB of source code and 40 MB on online docs.
  767.  
  768. C6. Does MachTen support hard links?
  769.  
  770. In UNIX, linking allows several file names to be associated with the same
  771. physical file. Power MachTen properly supports UNIX soft links and hard
  772. links via link(2). Professional MachTen only supports soft links.
  773.  
  774. ----------------------------------------------------------------------------
  775.  
  776. D. The X Window System:
  777.  
  778. D1. Can you explain the basic elements of X Windows software?
  779. D2. What is unique about Tenon's X?
  780. D3. Why is Tenon's X server so much faster than eXodus or MacX?
  781. D4. Does Tenon's X support 24-bit color?
  782. D5. What 3-button mice work under MachTen?
  783. D6. Can I buy X separately?
  784.  
  785. D1. Can you explain the basic elements of X Windows software?
  786.  
  787. The X Window System is a protocol for performing windowing functions across
  788. a network. "Windowing functions" means drawing lines, arcs and other
  789. graphics primitives on any type of console or display. As a protocol, it is
  790. implemented in a set of libraries freely available from the Massachusetts
  791. Institute of Technology (MIT).
  792.  
  793. If an application supports the X Window protocol, the graphical output of
  794. that application can be displayed on any X terminal. The application is
  795. called an "X client" and the X terminal is considered an "X server".
  796.  
  797. D2. What is unique about Tenon's X?
  798.  
  799. Because MachTen is a complete UNIX system, MachTen supports local X clients.
  800. The MachTen X Window Software includes a local Motif Window Manager (mwm)
  801. and an Open Look Virtual Window Manager (olvwm). The sources to many X
  802. client applications are included as example programs, along with a complete
  803. X client development environment and a Motif toolkit.
  804.  
  805. D3. Why is Tenon's X so much faster than eXodus or MacX?
  806.  
  807. Tenon's X architecture is very different than the other X servers that are
  808. traditional Macintosh applications. Tenon sends the output of the X commands
  809. directly to the Macintosh hardware screen buffers instead of using
  810. QuickDraw. This has profound performance implications. In addition, Tenon's
  811. X uses the UNIX TCP sockets for communications instead of MacTCP; this
  812. further improves performance.
  813.  
  814. Tenon's X is said to be the fastest on the Mac market. X11perf benchmarks on
  815. a 25MHz 68040 Centris yield an XMark of 1.1 -- better than a SPARCStation 1!
  816. On a 40MHz Quadra 840av, the X performance rivals a SPARCStation 2. XMark
  817. ratings are not yet available for the native X performance on a Power Mac,
  818. but Tenon's architectural advantage carries over to that platform as well.
  819.  
  820. D4. Does Tenon's X support 24-bit color?
  821.  
  822. Yes. X11R6 with 24-bit color is available with Professional MachTen 2.3 and
  823. also for Power MachTen via the Ported Application CD, Volume 2.
  824.  
  825. D5. What 3-button mice work under MachTen?
  826.  
  827. In general, Tenon's X Window Software can be configured to run with any
  828. three-button mouse. We have the most experience with the Logitech MouseMan.
  829. Customers have also reported that the Kensington 4-button mouse works well.
  830.  
  831. D6. Can I buy X separately?
  832.  
  833. Yes, if all you need is to have your remote X client applications display on
  834. your Power Mac desktop, simply buy XTen.
  835.  
  836. ----------------------------------------------------------------------------
  837.  
  838. E. File Handling/Management:
  839.  
  840. E1. Can MachTen access the MacOS file system?
  841. E2. Does MachTen have a native file system?
  842. E3. Does CodeBuilder have a native file system?
  843.  
  844. E1. Can MachTen access the MacOS file system?
  845.  
  846. Tenon maps the UNIX file system to the MacOS file system. So, with MachTen
  847. and MacOS, there is a single consistent file system. This means that
  848. everything is accessible to both MachTen and MacOS. You can 'see' the UNIX
  849. directories and files on the Finder desktop and you can 'see' the Macintosh
  850. folders and files from a UNIX terminal window using 'cd' and 'ls'.
  851.  
  852. E2. Does MachTen have a native file system?
  853.  
  854. MachTen uses the Macintosh file system (HFS) and adds a Network File System
  855. (NFS). MachTen 4.1 will ship with a native UNIX fast file system.
  856.  
  857. E3. Does CodeBuilder have a native file system?
  858.  
  859. CodeBuilder includes two support file trees: one is a Macintosh file system
  860. (HFS) and the other is a native fast file system (FFS). The developer can
  861. use either one, the tradeoff is performance vs. Mac Finder integration.
  862.  
  863. ----------------------------------------------------------------------------
  864.  
  865. F. Peripherals and Devices:
  866.  
  867. F1. What third party devices are compatible with MachTen?
  868. F2. Can I use third party accelerators with MachTen?
  869. F3. Can I use PowerPC upgrade cards with MachTen?
  870. F4. What CD-ROM drives and formats are compatible with MachTen?
  871.  
  872. F1. What third party devices are compatible with MachTen?
  873.  
  874. Because MachTen sits on top of MacOS and makes use of the MacOS device
  875. drivers, all third-party devices, in general, will work with MachTen.
  876. Ocassionally there are exceptions. For example, tape device drivers are
  877. generally bundled with the application and are not part of MacOS. Thus, tape
  878. required special attention on Tenon 's part. MachTen supports 4mm DAT tape
  879. drives and 8mm Exabyte tape drives. Tape support is not yet part of the
  880. standard product and must be requested from Tenon Technical support.
  881.  
  882. F2. Can I use third party accelerators with MachTen?
  883.  
  884. CPU accelerators tend to make use of Apple's memory management hardware.
  885. Therefore, in general, you can usually use accelerator boards as long as you
  886. are not using MachTen VM. DayStar boards are generally not compatible with
  887. MachTen.
  888.  
  889. F3. Can I use PowerPC upgrade cards with MachTen?
  890.  
  891. Power MachTen (Tenon's PPC native implementation of MachTen) runs with all
  892. PowerPC upgrade cards.
  893.  
  894. F4. What CD-ROM drives and formats are compatible with MachTen?
  895.  
  896. MachTen uses either Mac HFS or Foreign File Access for non-HFS formats, such
  897. as ISO 9660 and RockRidge, so MachTen can read any CD-ROM that the MacOS can
  898. read.
  899.  
  900. ----------------------------------------------------------------------------
  901.  
  902. G. Technical MachTen:
  903.  
  904. G1. Patches
  905.  
  906. G1.a. Do I need a patch?
  907. G1.b. What is the difference between the CU1 on the Ported Apps CD and the
  908. CU1 on the FTP site?
  909.  
  910. G2. Mail
  911.  
  912. G2.a. Do both versions of your product (Power MachTen and Professional
  913. MachTen) support POP mail service?
  914. G2.b. Why are Eudora users having so many problems retrieving their mail?
  915. G2.c. How do I start popper?
  916. G2.d. How do I start pop3d?
  917. G2.e. Why do some users get a "Mail drop locked" message from Eudora?
  918. G2.f. Is sendmail configured out of the box to send and receive mail over
  919. the Internet or do I have to configure it?
  920. G2.g. How do I configure sendmail to restrict the size of both incoming and
  921. outgoing mail to some arbitrary size?
  922. G2.h. How can I have a mail address name that is longer than eight
  923. characters?
  924. G2.i. Can I run popper and sendmail under MachTen and run the Apple Internet
  925. Mail Server under MacOS while MachTen is just doing the routing?
  926.  
  927. G3. Programming
  928.  
  929. G3.a. Where are the 48-bit random number generating functions (srand48,
  930. drand48, etc.)?
  931. G3.b. Why doesn't gprof tell me anything useful about gcc generated code?
  932. G3.c. Why can't I get STL containers to work with g++ 2.7.2?
  933. G3.d. How do I use gcc math functions?
  934. G3.e. Where are the xdr libraries?
  935. G3.f. I live outside the US and I need crypt.h to compile a program. Where
  936. is it?
  937. G3.g. When I run perl 5.003 under Power MachTen, it seems that I'm missing
  938. some essential libraries. What's the fix?
  939. G3.h. How do I update GNAT on CodeBuilder from 3.07 to 3.09?
  940. G3.i. Can a stand alone Mac application use the Tenon libraries for a hybrid
  941. application that makes MacOS API calls and Mach calls without the
  942. CodeBuilder environment running?
  943. G3.j. Will apps written for or ported to MachTen/CodeBuilder run under
  944. Rhapsody?
  945.  
  946. G4. Software and Hardware Compatibility
  947.  
  948. G4.a. I ran Norton Utilities on my Mac with MachTen and now MachTen doesn't
  949. run correctly. What happened? How can I fix it?
  950. G4.b. Is there a port of Netscape Navigator for MachTen?
  951. G4.c. Is Power MachTen, like Professional MachTen, incompatible with
  952. SilverLining?
  953. G4.d. Why does my system crash when I use RAM Doubler 1.5.2 (or earlier) and
  954. MachTen at the same time?
  955. G4.e. If I use Power MachTen with RAM Doubler 1.6.2 (or later), the systems
  956. hangs on shutdown after everything has successfully quit. How can I fix
  957. this?
  958. G4.f. Any recommendations for a 3-button mouse to use with X?
  959. G4.g. Any suggestions for an accelerator that will work with Professional
  960. MachTen?
  961. G4.h. Why does zsh crash my system?
  962. G4.i. Is MachTen compatable with Microsoft Internet Explorer?
  963.  
  964. G5. Networking
  965.  
  966. G5.a. Can I create my own mirror of the Tenon FTP site?
  967. G5.b. How can I tell who logged in via anonymous FTP and which files they
  968. accessed?
  969. G5.c. If I update some of my domain name database files, what must I type in
  970. order to load these new database files into the MachTen DNS server without
  971. restarting the system?
  972. G5.d. Is multihoming possible under Power MachTen if I disable
  973. OpenTransport's TCP/IP components and run with MachTen's TCP/IP stack?
  974. G5.e. Is it necessary to use MacTCP rather than OpenTransport in order to
  975. listen on multiple IP addresses for multihoming? Is MacTCP the better choice
  976. for MachTen versus OT 1.1.1?
  977. G5.f. Are there any secrets to making MachTen work through ARA without
  978. interfering with existing network conditions?
  979. G5.g. Can I run MacOS applications like NCSA Telnet and Netscape Navigator
  980. while running MachTen?
  981. G5.h. Why do I get a message like "can't run ld on NFS filesystem" when I
  982. try to run executables on NFS disks? How can I fix this?
  983. G5.i. What must I do to automatically start my installed version of Apache
  984. when MachTen is run?
  985. G5.j. How can I access Apache under MachTen from Netscape on the same
  986. machine?
  987. G5.k. Where can I get Netscape's Enterprise Server for MachTen?
  988. G5.l. Why can't I use MacPPP or FreePPP to set up my serial IP connection
  989. when MachTen is running?
  990. G5.m. What /dev/ttyxx setting should I use for an internal modem?
  991. G5.n. What is a netmask and how do I use one?
  992. G5.o. How can I make Power MachTen fully Open Transport compliant?
  993. G5.p. How can I make Power MachTen work with FreePPP or OT/PPP?
  994.  
  995. G6. System Stability and Robustness
  996.  
  997. G6.a. What tips in general do you have to keep MachTen stable?
  998. G6.b. Why does MachTen give the error message 'vmunix: file: table is full'
  999. when I try to run a program?
  1000. G6.c. Why does MachTen give the error message 'proc: table is full' when I
  1001. try to run a program?
  1002. G6.d. Why does MachTen give the error message '/vmunix: no namelist' when I
  1003. try to run a program?
  1004. G6.e. When I run several apps in MachTen at the same time and try to launch
  1005. another application, I get "Fragment Load Err: - 2810 - Not Enough Memory in
  1006. User's Address Space ...". I have plenty of memory left; what's the problem?
  1007. G6.f. When I am running MachTen, the performance is poor on any program that
  1008. accesses the disk. Moving the Scheduling Priority slider bar in the MachTen
  1009. control panel toward UNIX priority doesn't help. How can I speed up MachTen?
  1010. G6.g. My Power Mac has lots of memory and runs quite fast, but that is not
  1011. reflected in MachTen's performance. I have the UNIX <-> Mac slider on the
  1012. third tick mark from the Mac end and MachTen has a big chunk of memory. UNIX
  1013. on the PPC 601 at 100MHz should blaze. What's up?
  1014. G6.h. I want MachTen to run faster, so I'm going to give it 10 MBs of RAM.
  1015. Will this speed it up?
  1016. G6.i. Why are the load averages so high? On another workstation running a
  1017. lot more applications, I'm used to load averages around 0.4--0.6. If
  1018. MachTen's X is running, the load average rarely falls below 2. Is there some
  1019. way to improve performance?
  1020. G6.j. I installed MacOS 7.5.5 or 7.6 and MachTen 2.3 (or 2.2) won't start up
  1021. anymore. How can I fix this?
  1022. G6.k. MachTen fails to startup with the error "Can't find root vnode". How
  1023. can I fix this?
  1024.  
  1025. G7. Other System Issues
  1026.  
  1027. G7.a. When I telnet to a (non-MachTen) UNIX system, pressing the delete key
  1028. just gives a '^?' character; I have to press ctrl-H to backspace. How I can
  1029. make the delete key work correctly?
  1030. G7.b. I have a Stylewriter printer. Do you have a script that I can put into
  1031. the /etc/printcap file so I can print?
  1032. G7.c. When will virtual memory and protected memory use be implemented on
  1033. Power MachTen?
  1034. G7.d. Why can't I compile my C code that uses memory mapping system calls?
  1035. G7.e. I seem able to only start Macintosh applications from within Power
  1036. MachTen by becoming root, even though the documentation (and file
  1037. protections) indicate that any user should be able to do this. Why?
  1038. G7.f. How can I check the status of Mac applications launched from Power
  1039. MachTen?
  1040. G7.g. I have ftp'd some files using the Macintosh program Fetch. I had the
  1041. files downloaded as binary files. Is there any way to convert them to the
  1042. MachTen format so I can use them?
  1043. G7.h. Why do active network applications stop when I launch MachTen?
  1044. G7.i. I used adduser to create a user in the 'wheel' group, but when the
  1045. user tries to su I get "su: you are not in the correct group to su root".
  1046. Any suggestions?
  1047. G7.j. How can I access Macintosh disks other than the one that MachTen
  1048. resides on?
  1049. G7.k. Why do I get "Diskname on /Diskname: Device busy, some process using
  1050. this filesystem" when I try to mount a hard disk?
  1051. G7.l. How do I start up my Macintosh with Power MachTen as the Finder?
  1052. G7.m. How do I convert the old password files from Professional MachTen to
  1053. Power MachTen?
  1054. G7.n. I tried to change my root password, but the passwd program did not
  1055. prompt me for my current passwd before creating a new one. /etc/passwd still
  1056. lists the root passwd as *. Why?
  1057. G7.o. Where is rfork in Power MachTen?
  1058. G7.p. How can I safely mount a device to the /volume directory in Power
  1059. MachTen?
  1060. G7.q. How do I change the login banner of MachTen/CodeBuilder?
  1061. G7.r. I lost my root password, how can I recover it?
  1062. G7.s. How do I create an A/UX partition for a fast file system?
  1063. G7.t. Adduser does strange things to my Power MachTen 4.1 installation, how
  1064. can I fix it?
  1065.  
  1066. G8. Ported Applications
  1067.  
  1068. G8.a. Where is the "ported_apps" folder on the Power MachTen distribution
  1069. disk?
  1070. G8.b. Can you help me port an application or set up a ported application?
  1071. G8.c. I am trying to port some apps to MachTen. Which vendor's UNIX is
  1072. closest to MachTen?
  1073. G8.d. Why does Tenon have two CD's of ported apps?
  1074. G8.e. Why does Tenon suggest purchasing Ported Apps Volume 2 for use with
  1075. CodeBuilder?
  1076.  
  1077. G9. Miscellaneous
  1078.  
  1079. G9.a. How can I view an "info" file?
  1080.  
  1081. G10. X-Windows
  1082.  
  1083. G10.a. Is it possible to cut and paste from X Windows to the Mac desktop?
  1084. G10.b. How can I change the keyboard mapping under X?
  1085. G10.c. Where is libXshr?
  1086. G10.d. Why can't Mosaic find any URL's?
  1087. G10.e. Why do I get a "connection reset by peer" error message when I open a
  1088. local xterm window and try to rlogin to another system?
  1089. G10.f. Whenever X is running, the entire system is unstable, whether I'm
  1090. using MacTCP clients or X exclusively. Is there a configuration that will
  1091. make things more stable?
  1092. G10.g. The Tenon Web pages say that XTen is X11R6, but my Power MachTen came
  1093. with X11R5. Did I get an old MachTen distribution?
  1094. G10.h. I tried to launch XWindows with a ctrl-T, but I got the following
  1095. error: 'fatal IO error 32 (Broken pipe) on X server ":0.0"' What happened?
  1096. How do I fix it?
  1097. G10.i. The background for the X Window is 'opaque', i.e. I can't see my
  1098. underlying Mac windows. How do I do this on the Tenon X Server?
  1099. G10.j. Why does creating a new window from the File menu kill the X session?
  1100. G10.k. System memory likes to bloat up to 20 or so MBs whenever I have more
  1101. than a few things running under X. Is this normal?
  1102. G10.l. Is there a way to scale the display in X?
  1103. G10.m. X won't start on my system. It just goes to a white screen then drops
  1104. me back into the finder (or hangs the system) How do I fix this?
  1105.  
  1106. G1. Patches and updates
  1107.  
  1108. G1.a. Do I need a patch?
  1109.  
  1110. G1.a. If you are having problems with MachTen, the first question to ask
  1111. yourself is "Do I need a patch?" Check to see if your problem matches or is
  1112. similar to any of those below. If so, install the patch. If the problem
  1113. persists and this FAQ doesn't answer it, please contact us.
  1114.  
  1115. MachTen 4.0.3:
  1116.  
  1117.    * The system freezes or gives "MacTCP error" when using almost any
  1118.      networking software under MachTen or while MachTen is running.
  1119.    * Other systems can ping your MachTen machine but can't connect to it.
  1120.    * MachTen was killed during startup with line "at0:IP encapsulated in
  1121.      appletalk:net:0 node:1" or with "Network is unreachable".
  1122.    * Issuing rlogin, telnet and other remote commands gives "Unable to
  1123.      connect to remote host: Connection reset by peer".
  1124.    * Quitting Netscape 2.01 gives continual "Please wait for network
  1125.      operations to complete".
  1126.    * Internet Explorer 2.0 says it needs MacTCP version 2.0 when starting
  1127.      under MachTen.
  1128.    * PCI PowerMac freezes after exiting X and running ShutDown.
  1129.    * PCI PowerMac gives "Type one error" message when you click at the upper
  1130.      edge of an X window.
  1131.  
  1132. MachTen 4.0.2:
  1133.  
  1134.    * xconsole displayed following error message: " xterm:Error 29, errno 95:
  1135.      No bufferspace available".
  1136.    * Fragment Load Err: - 2807 - Loaded Fragment has Unacceptable Unresolved
  1137.      Symbols ... mgmainnet init: can't exec getty '/usr/libexec/getty' for
  1138.      port /dev/console: Input/output error.
  1139.    * telnet or rlogin to any host causes Macintosh to freeze.
  1140.    * Netscape Atlas won't run.
  1141.    * Error Type 1 when using the X Windows environment in full screen mode
  1142.      (..X -fs) and clicking on the upper edge to go see the menu.
  1143.    * sendmail problems, especially when trying to serve additional domains
  1144.      and sending attachments with the e-mail.
  1145.    * Macintosh hangs after launching pppclient.
  1146.    * pppclient script negotiates with the server to use the IP address that
  1147.      is set up for MachTen's ethernet interface, instead of using the
  1148.      pre-determined address for the PPP client.
  1149.  
  1150. MachTen 2.2:
  1151.  
  1152.    * An error occurs when MachTen is looking for MultiFinder in System 7.5.3
  1153.      and 7.5.5.
  1154.    * "Unimplemented Trap" after the line displaying hardware and net address
  1155.      in MachTen startup under System 7.5.2 or 7.5.3.
  1156.    * "Mouse cursor droppings" while running X 3.1 under MacOS 7.5.3 on a
  1157.      PowerBook 190 or under emulation on a PowerMac.
  1158.    * xdm starts X server but gives no login prompt.
  1159.  
  1160. XTen 6.0:
  1161.  
  1162.    * Netscape 2.0 and 3.0B2 hang the system if run while XTen is running
  1163.      (the latter hangs if I try to shut it down after running it from the
  1164.      Mac desktop -- MacTCP is trying forever to complete network services).
  1165.  
  1166. G1.b. What is the difference between the CU1 on the Ported Apps CD and the
  1167. CU1 on the FTP site?
  1168.  
  1169. The CU1 on the FTP site is newer and has the following additional features:
  1170.  
  1171.    * minor processor (604) dependent bug fixed
  1172.    * 1400/2300/5300 powerbook bug fixed
  1173.    * gdb on non-root volume bug fixed
  1174.  
  1175. G2. Mail
  1176.  
  1177. G2.a. Do both versions of your product (Power MachTen and Professional
  1178. MachTen ) support POP mail service?
  1179.  
  1180. Yes. We've recently found that popper (the public domain pop server that
  1181. ships with Power MachTen) has some inherent bugs in it, so we've ported a
  1182. different POP server, pop3d, that seems to work well. You can find pop3d on
  1183. the Ported Applications CD and on our FTP site.
  1184.  
  1185. G2.b. Why are Eudora users having so many problems retrieving their mail?
  1186.  
  1187. Some POP (e.g. popper) servers have a hard time with the following:
  1188.  
  1189.    * spaces or dots in passwords,
  1190.    * user id's of less than 10, or
  1191.    * user names with capital characters
  1192.  
  1193. The POP daemon is case sensitive, and it only wants lowercase. If your users
  1194. want to use POP clients, they will need to specify their user names all in
  1195. lowercase in the Eudora settings. Make sure that the UID of the person
  1196. trying to pop the mail is greater than 10. The UID requirement is hard coded
  1197. into the POP daemon. pop3d solves all these problems.
  1198.  
  1199. G2.c. How do I start popper?
  1200.  
  1201. Popper is enabled if the "enable incoming connections" box is checked. It
  1202. may not show up in the process list, however, since it is called on the fly
  1203. when an incoming connection comes in.
  1204.  
  1205. G2.d. How do I start pop3d?
  1206.  
  1207. Almost the same way as popper. Install pop3d. Then edit /etc/inetd.conf on
  1208. the line that begins with 'pop' -- change '/usr/libexec/popper' to
  1209. '/usr/libexec/pop3d' and change 'popper' to 'pop3d'. You must restart inetd
  1210. for the change to take effect. The simplest way to do this is to restart
  1211. MachTen.
  1212.  
  1213. G2.e. Why do some users get a "Mail drop locked" message from Eudora?
  1214.  
  1215. Delete the .pop.xxxx files in your mail server's spool directory. These
  1216. files occasionally remain locked when a POP connection is broken, so
  1217. deleting them should clear up the problem.
  1218.  
  1219. G2.f. Is sendmail configured out of the box to send and receive mail over
  1220. the Internet or do I have to configure it?
  1221.  
  1222. The MachTen control panel has an "enable incoming mail" box. If the
  1223. hostname, IP addresses, and domain name are all correct, sendmail should
  1224. work out of the box.
  1225.  
  1226. G2.g. How do I configure sendmail to restrict the size of both incoming and
  1227. outgoing mail to some arbitrary size?
  1228.  
  1229. We are not aware of any sendmail configuration option that will do this.
  1230.  
  1231. G2.h. How can I have a mail address name that is longer than eight
  1232. characters?
  1233.  
  1234. Assign an alias in the /etc/aliases file like this: webmaster: webmstr
  1235. All mail addressed to webmaster will then go to webmstr. You'll need to
  1236. restart MachTen for the change to take effect.
  1237.  
  1238. G2.i. Can I run popper and sendmail under MachTen and run the Apple Internet
  1239. Mail Server under MacOS while MachTen is just doing the routing?
  1240.  
  1241. That should be fine. Disable incoming connections and receipt of mail for
  1242. MachTen.
  1243.  
  1244. G3. Programming
  1245.  
  1246. G3.a. Where are the 48-bit random number generating functions (srand48,
  1247. drand48, etc.)?
  1248.  
  1249. These functions are part of UNIX System V. Since MachTen is BSD, these
  1250. functions are not included.
  1251.  
  1252. G3.b. Why doesn't gprof tell me anything useful about gcc generated code?
  1253.  
  1254. Gprof does not work for any version of gcc right now. We are working to
  1255. resolve this.
  1256.  
  1257. G3.c. Why can't I get STL containers to work with g++ 2.7.2?
  1258.  
  1259. G++'s template support isn't quite up to the task yet. FSF thinks g++ 2.8.0
  1260. will be able to fully utilize the STL.
  1261.  
  1262. G3.d. How do I use gcc math functions?
  1263.  
  1264. The math functions aren't in the libraries that are included by default when
  1265. you compile. Try
  1266.  
  1267. % cc test.c -lm
  1268.  
  1269. to include the math libraries.
  1270.  
  1271. G3.e. Where are the xdr libraries in MachTen?
  1272.  
  1273. They are included in CU1 for Power MachTen, which is on the PowerPC Ported
  1274. Apps CD and on our FTP site.
  1275.  
  1276. G3.f. I live outside the US and I need crypt.h to compile a program. Where
  1277. is it?
  1278.  
  1279. Due to munitions export regulations, it was not possible to include this
  1280. with MachTen for foreign distribution. You should have no problem finding
  1281. crypt.h on a non-US FTP site.
  1282.  
  1283. G3.g. When I run perl 5.003 under Power MachTen it seems that I'm missing
  1284. some essential libraries. What's the fix?
  1285.  
  1286. Perl 5.003 source, binaries, and the necessary libraries are included on the
  1287. PowerPC Ported Apps CD and on our FTP site.
  1288.  
  1289. G3.h. How do I update GNAT on CodeBuilder from 3.07 to 3.09?
  1290.  
  1291. Download the file
  1292. ftp://cs.nyu.edu/pub/gnat/powermac/gnat3.09-Codebuilder_ppc.tar.gz. Move it
  1293. to your CodeBuilder_HFS directory. Start up CodeBuilder and log in as root.
  1294. Change to the /hfs directory and run
  1295.  
  1296. dfork -i gnat3.09-Codebuilder_ppc.tar.gz
  1297. tar -zxvf /hfs/gnat3.09-Codebuilder-ppc.tar.gz
  1298.  
  1299. Now you may have to rebuild your Ada libraries, to do so:
  1300. cd /usr/macppc/lib/ada/MacOS
  1301. gcc -c -gnatp /usr/include/ada/MacOS/*.ad[sb]
  1302.  
  1303. This should only take a few minutes inside the FFS.
  1304.  
  1305. G3.i. Can a stand alone Mac application use the Tenon libraries for a hybrid
  1306. application that makes MacOS API calls and Mach calls without the
  1307. CodeBuilder environment running?
  1308.  
  1309. No, the calls could be made, but they rely on the interprocess communication
  1310. to talk to the Mach microkernel. Without this microkernel process, they
  1311. won't work. Technically, some calls might, but most of them will really need
  1312. to have CodeBuilder (or MachTen) running.
  1313.  
  1314. G3.j. Will apps written for or ported to MachTen/CodeBuilder run under
  1315. Rhapsody?
  1316.  
  1317. MachTen supports the same APIs as Rhapsody's core OS, so anything that runs
  1318. on MachTen will be able to run on Rhapsody.
  1319.  
  1320. G4. Software and Hardware Compatibility
  1321.  
  1322. G4.a. I ran Norton Utilities on my Mac with MachTen and now MachTen doesn't
  1323. run correctly. What happened? How can I fix it?
  1324.  
  1325. Norton Utilities changes any file name starting with a period to instead
  1326. start with a dash. Also, Norton unmangles the names of some files (mangling
  1327. is needed to tell the MacOS that, for example, 'INSTALL' and 'install' are
  1328. different files). This, of course, throws off MachTen. We recommend using
  1329. MacTools Pro from Central Point instead. To fix the Norton damage, the
  1330. options are pretty limited. Either rename all the files that Norton changed
  1331. back to their original names, or reinstall MachTen.
  1332.  
  1333. G4.b. Is there a port of Netscape Navigator for MachTen?
  1334.  
  1335. There is no Navigator for MachTen because Navigator is a commercial program
  1336. and the source is not available to us. We do offer Mosaic, which has a
  1337. publicly-available source.
  1338.  
  1339. G4.c. Is Power MachTen, like Professional MachTen, incompatible with
  1340. SilverLining?
  1341.  
  1342. Power MachTen is compatible with SilverLining. Since Power MachTen does not
  1343. implement UNIX virtual memory, the Professional MachTen problem with
  1344. SilverLining doesn't apply; however, this may become a problem again when we
  1345. implement UNIX virtual memory.
  1346.  
  1347. G4.d. Why does my system crash when I use RAM Doubler 1.5.2 (or earlier) and
  1348. MachTen at the same time?
  1349.  
  1350. RAM Doubler version 1.5.2 (or earlier) is not compatible with MachTen.
  1351.  
  1352. G4.e. If I use Power MachTen with RAM Doubler 1.6.2 (or later), the systems
  1353. hangs on shutdown after everything has successfully quit. How can I fix
  1354. this?
  1355.  
  1356. Install CU1. This will fix all known incompatibilities. We recommend using
  1357. these versions with MachTen 4.0.3 and CU1.
  1358.  
  1359. G4.f. Any recommendations for a 3-button mouse to use with X?
  1360.  
  1361. We use the Logitech MouseMan. Almost any mouse should work, but some
  1362. no-names have had some trouble.
  1363.  
  1364. G4.g. Any suggestions for an accelerator that will work with Professional
  1365. MachTen?
  1366.  
  1367. Almost any accelerator will operate correctly as long as it encompasses a
  1368. full upgrade (i.e., it doesn't leave out crucial operations, such as the
  1369. presence of an MMU). Some DayStar boards do not function correctly because
  1370. they do not support a working MMU system. There is no real list, as there
  1371. are so many cards out on the market and keeping track would be almost
  1372. impossible.
  1373.  
  1374. G4.h. Why does zsh crash my system?
  1375.  
  1376. It was ported by a Japanese customer, so we presume the crashing is related
  1377. to the differences in Japanese and American systems. Tenon Technical Support
  1378. may do a port someday, but there are quite a few higher priority items.
  1379.  
  1380. G4.i. Is MachTen compatable with Microsoft Internet Explorer?
  1381.  
  1382. Internet Explorer is an Open Transport-only application. If you are running
  1383. Tenon's TCP stack then Explorer will not run. If you demand this
  1384. functionality and are running Power MachTen 4.0.3 CU1 or later, then you can
  1385. run MachTen using Open Transport.
  1386.  
  1387. G5. Networking
  1388.  
  1389. G5.a. Can I create my own mirror of the Tenon FTP site?
  1390.  
  1391. Sure, but we'd like you to be authorized. Once you are authorized, we can
  1392. add you to the list of sites waiting to be on the mirror program. Contact
  1393. Jaime Julca to get started on a mirror site.
  1394.  
  1395. G5.b. How can I tell who logged in via anonymous FTP and which files they
  1396. accessed?
  1397.  
  1398. Almost all of that information is in /var/log/ftplog. You can't be certain
  1399. of who logged in by anonymous ftp, but you can at least get the site that
  1400. they came from, and the e-mail address that they gave as a password (plus
  1401. all the files they got).
  1402.  
  1403. G5.c. If I update some of my domain name database files, what must I type in
  1404. order to load these new database files into the MachTen DNS server without
  1405. restarting the system?
  1406.  
  1407. Most programs will usually restart when killed with a SIGHUP. To load the
  1408. new database files, run 'ps -aux' to get the pid (process ID) of 'named.
  1409. Then run 'kill -HUP pid' where 'pid' is the ID of 'named'. Also remember to
  1410. update your serial number in your DNS files, so as to allow for propagation
  1411. to other DNS servers.
  1412.  
  1413. G5.d. Is multihoming possible under Power MachTen if I disable
  1414. OpenTransport's TCP/IP components and run with MachTen's TCP/IP stack?
  1415.  
  1416. Yes, you can multihome if you disable OpenTransport and run with our TCP/IP
  1417. stack, .
  1418.  
  1419. G5.e. Is it necessary to use MacTCP rather than OpenTransport in order to
  1420. listen on multiple IP addresses for multihoming? Is MacTCP the better choice
  1421. for MachTen versus OT 1.1.1?
  1422.  
  1423. MachTen has its own TCP stack which allows multihoming. Neither MacTCP nor
  1424. OpenTransport have support for multihoming. In either case, MachTen's stack
  1425. should be used. MachTen's stack prefers to have MacTCP be the original
  1426. stack, so this is the preferred base.
  1427.  
  1428. G5.f. Are there any secrets in making MachTen work through ARA without
  1429. interfering with existing network conditions?
  1430.  
  1431. Remove the 'MacTCPdLib' from the MachTen Libraries folder. This will remove
  1432. MachTen's interaction with the Macintosh TCP/IP Stack. You *can* use both
  1433. OpenTransport and MachTenTCP if you have two IP addresses. If you move your
  1434. MacTCPdlib out of your Tenon Kernel Libraries (in the extensions folder),
  1435. the Mac applications will use OpenTransport. To do this, configure
  1436. OpenTransport on one IP address and MachTen on another.
  1437.  
  1438. G5.g. Can I run MacOS applications like NCSA Telnet and Netscape Navigator
  1439. while running MachTen?
  1440.  
  1441. Yes. As long as MachTen is the first TCP/IP application you run, you can run
  1442. any other TCP/IP application. MachTen must be the first one loaded because
  1443. it establishes its own networking environment, including its own TCP stack.
  1444. Other TCP/IP applications then run using MachTen's TCP stack.
  1445.  
  1446. G5.h. Why do I get a message like "can't run ld on NFS filesystem" when I
  1447. try to run executables on NFS disks? How can I fix this?
  1448.  
  1449. Because of the way MachTen runs them, you can't execute or link binaries
  1450. over NFS or any other file-sharing system that isn't AppleShare. This is
  1451. because we take advantage of the Code Fragment Manager in System 7. The
  1452. upside is that our executables occupy less RAM when running and can
  1453. dynamically allocate the RAM that they use. The downside is that you can't
  1454. link or execute binaries over non-AppleTalk networks. As a workaround, the
  1455. following script should help you.
  1456.  
  1457. #!/bin/sh
  1458. #
  1459. # Currently, MachTen running on PowerMacs can only execute programs
  1460. # located on Mac volumes (type ufs). If this is the case, just go do
  1461. # it. Otherwise, make a temporary copy of the program (presumably
  1462. # from NFS) in /tmp, run it from there, and clean up afterwards.
  1463.  
  1464. statfs $1 | grep -q ' ufs '
  1465. if [ $? -eq 0 ]; then
  1466. exec "$@"
  1467. fi
  1468.  
  1469. FN=$1 ; shift
  1470. TN=/tmp/$$-`basename $FN`
  1471. cp -p $FN $TN && $TN "$@"
  1472. val=$?
  1473. rm -f $TN
  1474. exit $val
  1475.  
  1476. G5.i. What must I do to automatically start my installed version of Apache
  1477. when MachTen is run?
  1478.  
  1479. You'll need to edit two files -- one is the /etc/rc file. Change the line
  1480. that says '/usr/libexec/httpd' to '/usr/local/etc/httpd'. Then, change the
  1481. /etc/rc.conf file so that START_httpd = "yes". That should do it.
  1482.  
  1483. G5.j. How can I access Apache under MachTen from Netscape on the same
  1484. machine?
  1485.  
  1486. First start Apache using the <httpd> command. Then you can access it with
  1487. Netscape at the following URL <http://localhost> or <http://127.0.0.1>
  1488.  
  1489. G5.k. Where can I get Netscape's Enterprise Server for MachTen?
  1490.  
  1491. There is no version of Netscape's Enterprise Server available for MachTen.
  1492. They only target some UNIX systems. We do have the Apache server available
  1493. on our ftp site, but the Enterprise server has some more features.
  1494.  
  1495. G5.l. Why can't I use MacPPP or FreePPP to set up my serial IP connection
  1496. when MachTen is running?
  1497.  
  1498. The IP layer within the MachTen BSD protocol stack does not provide an
  1499. interface to MacPPP or FreePPP, forcing the use of MachTen's PPP. The
  1500. OpenTransport interface to MachTen available with CU1 for Power MachTen
  1501. allows the use of MacPPP, MacSLIP and other transport protocols while
  1502. MachTen is running.
  1503.  
  1504. G5.m. What /dev/ttyxx setting should I use for an internal modem?
  1505.  
  1506. You will have to use the Communications Toolbox.
  1507.  
  1508. G5.n. What is a netmask and how do I use one?
  1509.  
  1510. Note: for this answer "address" refers to just the last number in an IP
  1511. address (e.g. 236.192.43.79 is just 79).
  1512.  
  1513. Think of the addresses that have been given to you as binary numbers.
  1514. 161 would be represented as:
  1515. 10100001 ( 128 + 32 + 1 = 161 )
  1516. And 175 would be represented as:
  1517. 10101111 ( 128 + 32 + 8 + 4 + 2 + 1 = 175 )
  1518. Your netmask, 240, would be represented as:
  1519. 11110000 ( 128 + 64 + 32 + 16 = 240 )
  1520.  
  1521. A netmask is like a face mask, with holes in it. The 1's are the holes, and
  1522. the 0's are the rest of the mask. So if you see the addresses as faces, and
  1523. the netmask as the mask, you can actually only see the first 4 bits - 1010.
  1524. Kind of like this:
  1525.  
  1526. "Face" (Address) 10100001
  1527. "Mask" (Netmask) 11110000
  1528. "You" (Router) 1010----
  1529.  
  1530. The router "looks" through the netmask at each bit of data on the network,
  1531. and if it's going to a destination that doesn't start with 1010, then it
  1532. knows it has to route that bit of data somewhere else. That's how routers
  1533. work. So your ISP has said that all of the machines on your network must
  1534. have addresses beginning with 1010. If you look at those numbers in binary,
  1535. that comes out as 10100000 to 10101111 (160-175).
  1536.  
  1537. Now, suppose you're trying to split this network, which has a total netmask
  1538. of 240 (11110000) into two networks. You can see that the largest either of
  1539. these subnets can be is 8 machines, because you'll need to have a larger
  1540. netmask for the router to work correctly. The next netmask you could pick
  1541. would be 248 (11111000), which only allows 8 machines to "look the same" to
  1542. the router:
  1543. 10100000 (160) 10100100 (164)
  1544. 10100001 (161) 10100101 (165)
  1545. 10100010 (162) 10100110 (166)
  1546. 10100011 (163) 10100111 (167)
  1547. - or -
  1548. 10101000 (168) 10101100 (172)
  1549. 10101001 (169) 10101101 (173)
  1550. 10101010 (170) 10101110 (174)
  1551. 10101011 (171) 10101111 (175)
  1552.  
  1553. So, if you're going to split your network up, you can't have more than 8
  1554. machines on each subnetwork - otherwise routing won't work. The only other
  1555. solution would be to call your Internet Service Provider and request more IP
  1556. numbers, say 160-191. That would give you a netmask of 224, and you could
  1557. use 240 as a subnet mask, giving you up to 16 machines on each subnet.
  1558.  
  1559. G5.o. How can I make Power MachTen fully Open Transport compliant?
  1560.  
  1561. First you must be at version 4.0.3 CU1. Make sure that Open Transport is on
  1562. using Apple's Network Software Selector which is included with the system
  1563. software. Now, using the Finder, open the folder /System
  1564. Folder/Extensions/Tenon Kernel Libraries. Inside this folder resides two
  1565. files, SocketLib and MacTCPdLib--move these to the folder /System
  1566. Folder/Extensions/Tenon Kernel Libraries/Disabled. Now in the folder /System
  1567. Folder/Extensions/Tenon Kernel Libraries/Disabled is a file called
  1568. OTSocketLib--move this file to the folder /System Folder/Extensions/Tenon
  1569. Kernel Libraries and reboot for full OT compliance.
  1570.  
  1571. G5.p. How can I make Power MachTen work with FreePPP or OT/PPP?
  1572.  
  1573. If FreePPP or OT/PPPis set up correctly on your system then just switch
  1574. MachTen to Open Transport compliance, and the next time you start MachTen,
  1575. it will start FreePPP or OT/PPP for you (if it isn't already running).
  1576.  
  1577. G5.q. How do I create a pppclient chat script?
  1578.  
  1579. A ppp chat script is composed of lines of the form:
  1580.  
  1581. receive send
  1582.  
  1583. In the situation above, when chat receives the word ``receive,'' it sends
  1584. the word ``send.'' The information to send and receive need only be
  1585. seperated by a white space, so in order to send or receve multiple words,
  1586. one must use the double-quote (") to surround the text like this:
  1587.  
  1588. "multiple words to receive" "and now multiple words to send"
  1589.  
  1590. G5.r. I'm trying to establish a PPP connection, my modem appears to connect
  1591. from the sound but nothing happens. What's wrong?
  1592.  
  1593. Probably pppclient is expecting the server to send "login:" and that isn't
  1594. occuring. ppplogin isn't that intelligent, it needs to have specific
  1595. instructions, so if the situation is just a little bit different that you'd
  1596. expect, it doesn't work.
  1597.  
  1598. If you turn on debugging (by typing "pppclient debug" instead of just
  1599. "pppclient"), pppclient will tell you what's going on while it's trying to
  1600. log in and connect. Look for lines that say "alarm". That means that
  1601. pppclient waited 45 seconds for whatever was on the previous line (probably
  1602. login: or password:) and it was never sent from the server. Find out what
  1603. line it's expecting. Then dial your ISP with a terminal program like ZTerm
  1604. or VersaTerm from the Macintosh side, and see what comes up. Find out if you
  1605. need to type return a couple of times before that login: prompt comes up. If
  1606. you do, then at the "" "" line, change that to "" "\d\n\n\n" (that means as
  1607. soon as the modem connects, wait one second (\d) and type return (\n) three
  1608. times.)... Mess around with it a little bit until you get to a script that
  1609. works. Use that debug option to see what's going on.
  1610.  
  1611. Remember that login scripts are very much a "trial and error" sort of
  1612. endeavor, on all kinds of computers. It may take a few tries before you get
  1613. it right.
  1614.  
  1615. G5.s. Why does my ppp connection drop the line?
  1616.  
  1617. Try using ttyfa or ttya instead of using cm.out This sometimes proves to be
  1618. more reliable than using the communcations tool box. There are instructions
  1619. on how to do this in the pppclient script. Basically all it requires to be
  1620. done is change the LINE variable and change the chat script to allow for the
  1621. dialing of the modem by MachTen.
  1622.  
  1623. G5.t. How do I know the dynamic IP address that is allocated to my system
  1624. for a PPP session?
  1625.  
  1626. Typing "ifconfig ppp0" at the prompt will tell you the address ppp is using.
  1627.  
  1628. G6. System Stability and Robustness
  1629.  
  1630. G6.a. What tips in general do you have to keep MachTen stable?
  1631.  
  1632. Watch your memory. Running Netscape 3.0 and MachTen at the same time is a
  1633. bad idea if you have only 16 MB of RAM. Run a disk error checker often and a
  1634. disk defragmenter at least once every three weeks (assuming daily use of
  1635. MachTen). Install all necessary patches and updates.
  1636.  
  1637. G6.b. Why does MachTen give the error message 'vmunix: file: table is full'
  1638. when I try to run a program?
  1639.  
  1640. This error is caused by the open files value in the MachTen control panel
  1641. being set to low. Increase the number of files allowed to be opened in the
  1642. control panel and the error message will disappear. Don't increase the open
  1643. files value too drastically, because each file handle requires memory.
  1644. Ideally, increase the open files value in increments of 20, until the error
  1645. message no longer appears.
  1646.  
  1647. G6.c. Why does MachTen give the error message 'proc: table is full' when I
  1648. try to run a program?
  1649.  
  1650. You are unable to start another process because you are at the maximum
  1651. capacity. You can raise the maximum using the MachTen Control
  1652. Panel/Memory/UNIX Processes.
  1653.  
  1654. G6.d. Why does MachTen give the error message '/vmunix: no namelist' when I
  1655. try to run a program?
  1656.  
  1657. If you rename your MachTen application to something else, this will happen.
  1658. This might also happen if the MachTen application is moved away from where
  1659. it was originally installed. These programs scan the kernel for information.
  1660. If the kernel isn't where they think it is, they give you this error. This
  1661. error can also occur when running MachTen on top of OpenTransport using the
  1662. OT Socket Library with network utilities.
  1663.  
  1664. G6.e. When I run several apps in MachTen at the same time and try to launch
  1665. another application, I get "Fragment Load Err: -2810 - Not Enough Memory in
  1666. User's Address Space ..." I have plenty of memory left. What's the problem?
  1667.  
  1668. MachTen is running out of memory in "User's Address Space", which means
  1669. within the application. Increase the amount of memory you give to the
  1670. MachTen application by a megabyte or so, and restart.
  1671.  
  1672. G6.f. When I am running MachTen the performance is really poor on any
  1673. program that accesses the disk. Moving the Scheduling Priority slider bar in
  1674. the MachTen control panel toward UNIX priority doesn't help. How can I speed
  1675. up MachTen?
  1676.  
  1677. Move the slide bar in the MachTen control panel down toward the MacOS. By
  1678. running MachTen at the highest priority you are wasting cycles waiting for
  1679. the MacOS to get a time slice for disk activity. Try pulling the slide bar
  1680. down closer to the middle. In tech support, we generally leave the slider
  1681. three ticks from the UNIX end. You can put this one or two tick marks closer
  1682. to the UNIX side when compiling or running other processor-intensive
  1683. application in MachTen. Also, we recommend not running MachTen and File
  1684. Sharing at the same time.
  1685.  
  1686. G6.g. My Power Mac has lots of memory and runs quite fast, but that is not
  1687. reflected in MachTen's performance. I have the UNIX <-> Mac slider on the
  1688. third tick mark from the Mac end and MachTen has a big chunk of memory. UNIX
  1689. on the PPC 601 at 100MHz should blaze. What's up?
  1690.  
  1691. The major bottleneck in terms of I/O and performance is caused solely by
  1692. MacOS. This will change when we come out with our fast file system. For the
  1693. time being the only workaround is something like Speed Doubler.
  1694.  
  1695. G6.h. I want MachTen to run faster, so I'm going to give it 10 MB's of RAM.
  1696. Will this speed it up?
  1697.  
  1698. You probably don't want to allocate more than about 5 MB to the MachTen
  1699. application, since MachTen actually gets most of its memory from the System
  1700. software. You'll notice that if you watch the About This Macintosh... box
  1701. (Apple Menu, in the Finder) while doing some intense processing in MachTen,
  1702. the System Software bar will grow rapidly. That's MachTen allocating memory.
  1703. If you give the MachTen application too much memory, it won't be able to get
  1704. its memory from the System, and it may randomly crash or give 'out of
  1705. memory' errors.
  1706.  
  1707. G6.i. Why are the load averages so high? On another workstation running a
  1708. lot more applications, I'm used to load averages around 0.4-0.6. If
  1709. MachTen's X is running, the load average rarely falls below 2. Is there some
  1710. way to improve performance?
  1711.  
  1712. The load averages are reported differently under MachTen. This load average
  1713. is by no means a measure of system performance. Load averages are not meant
  1714. for speed comparisons. Typically a high load average (say 10+) is an
  1715. indicator that you need a faster, more powerful machine. The load average is
  1716. calculated by counting the number of processes waiting for the processor.
  1717. The MacOS is always counted as a waiting process, so our load average is
  1718. typically one higher than you would expect.
  1719. G6.j. I installed MacOS 7.5.5 or 7.6 and MachTen 2.3 (or 2.2) won't start up
  1720. anymore. How can I fix this?
  1721.  
  1722. First, download new kernels from ftp://ftp.tenon.com/pub/updates/2.3/. Get
  1723. the files unix.hqx and vmunix.hqx. Now, after decompressing these files,
  1724. place them in the MachTen 2.3 Root/MachTen folder on your hard drive. Start
  1725. the MachTen control panel, and while holding down the 'Option' key select
  1726. 'General'. In the window that opens is a box labeled 'MultiFinder Offset'
  1727. which is probably set to '0'. Set this to '1900' for MacOS 7.5.5 and to
  1728. '1876' for MacOS 7.6, save, exit, and start MachTen.
  1729.  
  1730. G6.k. MachTen fails to startup with the error "Can't find root vnode". How
  1731. Can I fix this?
  1732.  
  1733. There are two volumes on your computer with the same name, probably the hard
  1734. drive that MachTen is installed on is the same as the name of the MachTen
  1735. CD. Change the name of the hard drive to a one that doesn't conflict with
  1736. other volumes.
  1737.  
  1738. G7. Other System Issues
  1739.  
  1740. G7.a. When I telnet to a (non-MachTen) UNIX system, pressing the delete key
  1741. just gives a '^?' character; I have to press ctrl-H to backspace. How I can
  1742. make the delete key work correctly?
  1743.  
  1744. At the command line on the foreign system type 'stty erase [DELETE KEY]'. If
  1745. you access the foreign system primarily through MachTen, then you should put
  1746. the 'stty erase [DELETE KEY]' line in a login script such as .login or
  1747. cshrc, so it will change the delete to backspace every time you log into
  1748. the foreign system. Incidentally, [DELETE KEY] means press the key, not to
  1749. type out DELETE KEY.
  1750.  
  1751. G7.b. I have a Stylewriter printer. Do you have a script that I can put into
  1752. the /etc/printcap file so I can print?
  1753.  
  1754. MachTen does not support QuickDraw based Stylewriters, only line and
  1755. PostScript printers. You can use a Stylewriter as a straight ASCII line
  1756. printer by setting up an entry in the printcap as an ASCII printer pointing
  1757. to a serial device. There are examples in the /etc/printcap file on how to
  1758. do this.
  1759.  
  1760. G7.c. When will virtual memory and protected memory use be implemented on
  1761. Power MachTen?
  1762.  
  1763. Virtual memory and protected memory, features of our 68K version of MachTen,
  1764. have always been a top priority for Tenon. However, perturbations in Apple's
  1765. OS strategy have made this development very problemmatic. In the absence of
  1766. virtual memory and protected memory, Tenon has worked hard to make Power
  1767. MachTen a very substantial software development platform. Even in a 'real
  1768. memory' system, we are able to port applications with over a million lines
  1769. of code with good results.
  1770.  
  1771. G7.d. Why can't I compile my C code that uses memory mapping system calls?
  1772.  
  1773. Memory mapping will not work under Power MachTen since we do not yet have a
  1774. true UNIX virtual memory implementation. I would recommend that you, instead
  1775. of using distinct processes and trying to communicate between them, try
  1776. using a multithreaded approach -- we do have the POSIX threads library, and
  1777. all threads share the same memory space. Alternately, you can use sockets
  1778. for IPC.
  1779.  
  1780. G7.e. I only seem able to start Macintosh applications from within Power
  1781. MachTen by becoming root, even though the documentation (and file
  1782. protections) indicate that any user should be able to do this. Why?
  1783.  
  1784. As of now only root, or users authorized in the following manner, can
  1785. execute Mac apps -- the Power MachTen documentation is incorrect. Before
  1786. proceeding, please recognize that allowing users to run Macintosh
  1787. applications will make your system significantly less secure. To allow users
  1788. to run Macintosh applications, you have to change the resource settings of
  1789. the MachTen application. First start MachTen and get the user ID (the
  1790. numbers) of the users you want to allow to run Macintosh applications. Exit
  1791. MachTen and start ResEdit. Inside ResEdit, open the MachTen application (in
  1792. the MachTen Root:MachTen folder). Double click on the Luid icon, this will
  1793. open a window titled "Luids from MachTen". In that window, double click on
  1794. the line that contains "Launch User ID's". This will open a window titled
  1795. "Luid 'Launch User IDs' ID=-8192 from MachTen". Highlight the last number in
  1796. this window with your mouse, then select "Insert New Field(s)" from the
  1797. Resources menu. This will create a box below the highlighted number; in that
  1798. box enter one of the user id's that you previously retrieved. Repeat this
  1799. process: select last number, etc. until you have entered all the user id's
  1800. that you want. Remember to save the file.
  1801.  
  1802. G7.f. How I can check the status of Mac applications launched from Power
  1803. MachTen?
  1804.  
  1805. Power MachTen, unlike Professional MachTen, is unable to check the status of
  1806. currently running Macintosh applications.
  1807.  
  1808. G7.g. I have ftp'd some files using the Macintosh program Fetch. I had the
  1809. files downloaded as binary files. Is there any way to convert them to the
  1810. MachTen format so I can use them?
  1811.  
  1812. Fetch (and basically all other Macintosh apps) saves your files with both a
  1813. resource fork and a data fork. Before using the file in MachTen, the
  1814. resource fork should be removed by running 'dfork -i <filename>'.
  1815.  
  1816. G7.h. Why do active network applications stop when I launch MachTen?
  1817.  
  1818. As long as the MachTen TCP/IP stack is used, all running TCP/IP applications
  1819. must be quit before launching MachTen. With CU1 for Power MachTen, the
  1820. requirement to quit Macintosh TCP/IP applications before MachTen launch is
  1821. eliminated.
  1822.  
  1823. G7.i. I used adduser to create a user in the 'wheel' group, but when the
  1824. user tries to su I get "su: you are not in the correct group to su root" Any
  1825. suggestions?
  1826.  
  1827. Do you have a line in /etc/group that says:
  1828. wheel:*:0:root,your_user
  1829. What's important here is that wheel is group ID 0, and the list of users is
  1830. delimited by the comma. The adduser command may not correctly set your
  1831. group. Check the /etc/groups file and add it manually if needed.
  1832.  
  1833. G7.j. How can I access Macintosh disks other than the one that MachTen
  1834. resides on?
  1835.  
  1836. You can mount desktop items. For example, if you have a volume called "Hard
  1837. Disk" on your desktop, you can mount it with 'mount "Hard Disk" /mnt' where
  1838. /mnt is your local mount point.
  1839.  
  1840. G7.k. Why do I get "Diskname on /Diskname: Device busy, some process using
  1841. this filesystem" when I try to mount a hard disk?
  1842.  
  1843. This message means that either you have the drive mounted at another
  1844. location, or that the disk is password protected or locked by a Macintosh
  1845. securty application.
  1846.  
  1847. G7.l. How do I start up my Macintosh with Power MachTen as the Finder?
  1848.  
  1849. At this time the you can do one of two things. You can rename the NoFinder
  1850. application to Finder, rename the Finder something else and reboot. Your
  1851. machine will boot NoFinder and you can start applications from there. You
  1852. can also boot normally and use NoFinder to kill the Finder. Right now there
  1853. is no way to boot Power MachTen automatically without the Finder or
  1854. NoFinder. Alternatively, the NoFinder application can be used to terminate
  1855. Finder. NoFinder is available at
  1856. file://ftp.tenon.com/pub/applications/contributed/NoFinder.gz
  1857.  
  1858. G7.m. How do I convert the old password files from Professional MachTen to
  1859. Power MachTen?
  1860.  
  1861. Because Power MachTen is BSD 4.4 compliant, we have moved to the shadow
  1862. password suite. As a result, the old databases are no longer compatible. The
  1863. following two perl scripts will convert the password files for you. The
  1864. first takes your passwd file and outputs what your master.passwd should look
  1865. like. Just run it and redirect your output to /etc/master.passwd. You should
  1866. also chmod 600 this file so only root can read it. The second modifies your
  1867. passwd file so it no longer contains the passwords. You should back up your
  1868. passwd file before you try any of this, in case anything goes wrong. If you
  1869. don't already have perl, you can get it from our ftp site.
  1870.  
  1871. Using the "vipw" command, you should edit the password information. Just
  1872. modify it so it will update the database, i.e., change something then change
  1873. it back. When you exit vipw, it will build the spwd.db and pwd.db databases.
  1874.  
  1875. **** First Script ****
  1876. #!/usr/local/bin/perl
  1877.  
  1878. open(PASSWD, "/etc/passwd");
  1879.  
  1880. while(<PASSWD>){
  1881. chop;
  1882. ($name, $password, $uid, $gid, $realname, $homedir, $shell) = split(/:/);
  1883. print
  1884. "$name:$password:$uid:$gid::0:0:0:$realname:$homedir:$shell\n" ;
  1885. }
  1886.  
  1887. **** Second Script ****
  1888. #!/usr/local/bin/perl
  1889.  
  1890. open(PASSWD, "/etc/passwd");
  1891.  
  1892. while(<PASSWD>){
  1893. chop;
  1894. ($name, $password, $uid, $gid, $realname, $homedir, $shell) =
  1895. split(/:/);
  1896. print "$name:\*:$uid:$gid::$realname:$homedir:$shell\n" ;
  1897. }
  1898.  
  1899. G7.n. I tried to change my root password, but the passwd program did not
  1900. prompt me for my current password before creating a new one. /etc/passwd,
  1901. still lists the root passwd as *. Why?
  1902.  
  1903. The passwd program does not ask for your old password when changing it.
  1904. Power MachTen uses shadow password that it keeps in a separate encrypted
  1905. file. Your /etc/passwd file should contain * for the passwords. Refer to the
  1906. passwd man page for more details.
  1907.  
  1908. G7.o. Where is rfork in Power MachTen?
  1909.  
  1910. We did not set this up correctly in Power MachTen. You must make a soft link
  1911. between dfork and rfork: 'ln -s rfork dfork'. When rfork runs, it will
  1912. notice its name and act accordingly.
  1913.  
  1914. G7.p. How can I safely mount a device to the /volume directory in Power
  1915. MachTen?
  1916.  
  1917. On Power MachTen startup, as part of the cleanup, MachTen deletes the
  1918. contents of the /volume directory. Potential results, if a disk or partition
  1919. is mounted to /volume using /etc/fstab are obvious. The following changes to
  1920. "/etc/rc" will solve the problem. Details about "/volume" and its
  1921. directories are included below. In "/etc/rc" change:
  1922.  
  1923. $ECHO -n " /volume"; cd /volume && $RM -fr *
  1924.  
  1925. to:
  1926.  
  1927. $ECHO -n " /volume"; cd /volume && /bin/rmdir * 2>/dev/null
  1928.  
  1929. The intent of cleaning "/volume" is to remove old directory entries which
  1930. were previously used as mount points for Macintosh volumes, NOT the contents
  1931. of any volume currently mounted there! "rmdir" will remove a directory
  1932. if-and-only-if it is empty and not mounted on, which is what we want.
  1933. Directory entries are created in "/volume" by "macmntd(8)". Macmntd get a
  1934. signal when a removable Mac volume comes online. It gleans the name of the
  1935. new Macintosh volume, then check "/etc/fstab" for an entry dictating where
  1936. to mount this volume. If no entry exists in fstab, macmntd creates a
  1937. directory in "/volume", using the Macintosh volume name. It then mounts the
  1938. new Mac volume on this directory. When the removable volume is ejected, or
  1939. MachTen quits, the directory entry remains in "/volume". Thus "/volume"
  1940. could, over time, get cluttered with directory entries.
  1941.  
  1942. G7.q. How do I change the login banner of MachTen/CodeBuilder?
  1943.  
  1944. Change the default entry in the /etc/gettytab file. This is the line to
  1945. change:
  1946.  
  1947. default:\
  1948.  
  1949.  
  1950. G7.r. I lost my root password, how can I recover it?
  1951.  
  1952. You must have physical access to the computer. During system startup, wait
  1953. until you see the "Cleaning up..." on the startup screen, then quickly press
  1954. CTRL-C two or three times. This will halt the system startup, press RETURN
  1955. one time to enter MachTen in single-user mode. You should be at a '#'
  1956. prompt. Type '/usr/bin/passwd' then change the root password when prompted.
  1957. Now run 'sync' twice from the '#' prompt, then run '/sbin/reboot'. Once
  1958. MachTen quits completely, drag and drop the MachTen_FFS or CodeBuilder_FFS
  1959. onto 'Fast File First Aid" repeatedly until FFFA gives the FFS file a clean
  1960. bill of health. Restart MachTen and login with your new root password.
  1961.  
  1962. G7.s. How do I create an A/UX partition for a fast file system?
  1963.  
  1964. As far as we know, you cannot do this with Drive Setup. We recommend using
  1965. FWB's Hard Disk Toolkit, simply set the Partition Type to Apple_UNIX_SVR2
  1966. when creating a scratch partition.
  1967.  
  1968. G7.t. Adduser does strange things to my Power MachTen 4.1 installation, how
  1969. can I fix it?
  1970.  
  1971. Please read MachTen 4.1 Adduser Problems, with Fixes.
  1972.  
  1973. G8. Ported Applications
  1974.  
  1975. G8.a. Where is the "ported_apps" folder on the Power MachTen distribution
  1976. disk?
  1977.  
  1978. Sorry for the confusion, but the documentation is in error. On the Power
  1979. MachTen 4.0.3 disk there is no "ported_apps" folder. You can get source for
  1980. ported apps from our ftp site and from the Power Mac Ported Applications CD,
  1981. which contains source and binaries.
  1982.  
  1983. G8.b. Can you help me port an application or set up a ported application?
  1984.  
  1985. Quite possibly. We can help with "core" applications such as Apache or INN
  1986. or other apps that are run on a standard Internet-aware UNIX system. If you
  1987. have a large, intricate and obscure application, we may not be able to help
  1988. as much, simply because we may not have the resources required to understand
  1989. the intricacies of your application. We will, of course, help as much as we
  1990. can with any specific MachTen-related questions you might have.
  1991.  
  1992. G8.c. I am trying to port some apps to MachTen. Which vendor's UNIX is
  1993. closest to MachTen?
  1994.  
  1995. Since MachTen is a straight BSD port, anything BSD is a good choice. If the
  1996. source has flags for BSD, it's a great place to start. The next best are
  1997. NexT or SunOS. You will have to recompile anything that was not compiled for
  1998. MachTen. O'Reilly has a good book on porting UNIX programs.
  1999.  
  2000. G8.d. Why does Tenon have two CD's of ported apps?
  2001.  
  2002. Ported Apps Volume 1 is for Professional MachTen. Volume is applications for
  2003. Power MachTen.
  2004.  
  2005. G8.e. Why does Tenon suggest purchasing Ported Apps Volume 2 for use with
  2006. CodeBuilder?
  2007.  
  2008. Two reasons. First, Ported Apps extends CodeBuilder's suite to include
  2009. advanced UNIX-based tools. Second, Ported Apps comes with over 200 MB of
  2010. source code, which can be used to develop UNIX-based or standalone Macintosh
  2011. applications.
  2012.  
  2013. G9. Miscellaneous
  2014.  
  2015. G9.a. How can I view an "info" file?
  2016.  
  2017. You can view .info files with emacs: type meta-x info and hit return, and it
  2018. will bring up lots of interesting information, including tutorials. (The
  2019. meta key is usually your escape key.) Alternatively, you can view it using
  2020. TeXinfo. Both emacs and TeXinfo are available on the Ported Apps CD.
  2021.  
  2022. G10. X Windows
  2023.  
  2024. G10.a. Is it possible to cut and paste from X Windows to the Mac desktop?
  2025.  
  2026. The fact that our X consumes the screen is a direct result of our X
  2027. architecture. Sending the X drawing primitives directly to the hardware
  2028. screen buffers give us a big performance advantage. What we lose, of course,
  2029. is the 'cut & paste' capability that we would get for 'free' from QuickDraw.
  2030. Even though our X is exactly what you would get if you bought an X terminal,
  2031. we recognize that, since we are running on a Mac, people expect 'cut &
  2032. paste'. This is a feature that, from the beginning, was planned for a future
  2033. upgrade. As a workaround you can copy your text to the X clipboard, then
  2034. save the clipboard to a file and access the file from MachTen windows or
  2035. with BBEdit.
  2036.  
  2037. G10.b. How can I change the keyboard mapping under X?
  2038.  
  2039. Checkout is the xmodmap program. It will allow you to manipulate your
  2040. keyboard mappings, or you can move the appropriate Xmodmap (located in
  2041. /usr/X11/lib/X11/xinit/) to your home directory and remap the key within the
  2042. file.
  2043.  
  2044. G10.c. Where is libXshr?
  2045.  
  2046. LibXshr is a library that was present in earlier versions of MachTen, but is
  2047. no longer used. Binaries compiled under previous versions need to be
  2048. recompiled.
  2049.  
  2050. G10.d. Why can't Mosaic find any URL's?
  2051.  
  2052. When X appears to start but Mosaic complains that the URL cannot be found,
  2053. it is an indication that the Web server (httpd) has not started. Using the
  2054. OpenWindows menu, start an xterm and use the <ps -aux | grep httpd> command
  2055. to verify that the server is not running. Edit the
  2056. /etc/httpd/conf/httpd.conf file. Uncomment the following line:
  2057.  
  2058. #ServerName new.host.name
  2059.  
  2060. In addition, you can change the entry <new.host.name> to a name of your
  2061. choice. Save the file and start the Web server with the <httpd -x> command.
  2062. To gain access to the X configuration pages, push the reload button within
  2063. Mosaic or restart Mosaic.
  2064.  
  2065. G10.e. Why do I get a "connection reset by peer" error message when I open a
  2066. local xterm window and try to rlogin to another system?
  2067.  
  2068. Try setting the TCP/IP control panel (the one for Open Transport) to "Load
  2069. Only When Needed". (You can get to this by clicking the "Options..."
  2070. button).
  2071.  
  2072. G10.f. Whenever X is running, the entire system is unstable, whether I'm
  2073. using MacTCP clients or X exclusively. Is there a configuration that will
  2074. make things more stable?
  2075.  
  2076. Get all updates (XTen users should upgrade to 6.0.1+). If this doesn't help,
  2077. try taking the TCP/IP control panel out of the Control Panels folder. On
  2078. some systems, this can greatly help our dealings with OpenTransport.
  2079.  
  2080. G10.g. The Tenon Web pages say XTen is X11R6, but my Power MachTen came with
  2081. X11R5. Did I get an old MachTen distribution?
  2082.  
  2083. MachTen ships with R5, but XTen ships with R6. MachTen with X11R6 is
  2084. available on the PPC Ported Apps CD. CU1 is also included on this disk and
  2085. should be installed before installing X11R6.
  2086.  
  2087. G10.h. I tried to launch XWindows with a ctrl-T, but I got the following
  2088. error: 'fatal IO error 32 (Broken pipe) on X server ":0.0"' What happened?
  2089. How do I fix it?
  2090.  
  2091. MachTen 4.0.x comes with X11R5, which supports only up to 256 colors. Make
  2092. sure that your monitor is set to 256 colors. An incorrect monitor depth is
  2093. usually the cause of the above error message.
  2094.  
  2095. G10.i. The background for the X Window is 'opaque', i.e. I can't see my
  2096. underlying Mac windows. How do I do this on the Tenon X Server?
  2097.  
  2098. There is no way to use "rootless" windows in MachTen. Dedicated X windows
  2099. enhances performance many-fold.
  2100.  
  2101. G10.j. Why does creating a new window from the File menu kill the X session?
  2102.  
  2103. It doesn't. Visit the window menu and reselect the X session as the window
  2104. you would like to view.
  2105.  
  2106. G10.k. System memory likes to bloat up to 20 or so MBs whenever I have more
  2107. than a few things running under XTen. Is this normal?
  2108.  
  2109. Traditionally, X assumes your system has limitless memory, so this is normal
  2110. behavior for any X system. Most of the memory allocation from MachTen/XTen
  2111. takes place in conjunction with the Code Fragment Manager, which allows us
  2112. to dynamically allocate memory in the System bar. Very little allocation
  2113. happens within the MachTen/XTen program space, which is why we ship with a
  2114. rather low amount of memory assigned to MachTen/XTen in the "Get Info" box.
  2115.  
  2116. G10.l. Is there a way to scale the display in X?
  2117.  
  2118. No, but you could bump up the monitor resolution (if your monitor and
  2119. computer support higher resolutions).
  2120.  
  2121. G10.m. X won't start on my system. It just goes to a white screen then drops
  2122. me back into the finder (or hangs the system) How do I fix this?
  2123.  
  2124. The two most likely possibilities are not enough memory or lack of
  2125. networking. If you are running only the MacOS and MachTen, set memory for at
  2126. least 32 MB. X will also fail to start if MachTen is configured to use
  2127. OpenTransport networking and there is no network active (e.g. PPP not
  2128. connected). Simply quit MachTen and open the folder /System
  2129. Folder/Extensions/Tenon Kernel Libraries. Inside this folder resides
  2130. OTSocketLib--move this to the folder /System Folder/Extensions/Tenon Kernel
  2131. Libraries/Disabled. Now in the folder /System Folder/Extensions/Tenon Kernel
  2132. Libraries/Disabled is a file called SocketLib--move this file to the folder
  2133. /System Folder/Extensions/Tenon Kernel Libraries, reboot your computer and
  2134. try X again.
  2135.  
  2136. Copyright(c)1998 Tenon Intersystems, 1123 Chapala Street, Santa Barbara, CA
  2137. 93101. All rights reserved.
  2138.