CHAPTER 2

Late-Breaking Solaris Runtime Bugs

---

This chapter describes known runtime problems. You may also want to refer to the online runtime_bugs file in the SUNWrdm package on the Solaris CD for additional runtime problems.

---

Note - The information in this chapter supplements any information listed in the runtime_bugs file that is part of the SUNWrdm package on the Solaris 2.6 CD. If you boot from the Solaris 2.6 CD, the runtime_bugs file is located in the /cdrom/sol_2.6_x86/s1/Solaris_2.6/Docs/release_info/C directory. The default installed location for the runtime_bugs file is the /usr/share/ release_info/Solaris_2.6/C directory.

---

---

Performance Note

TCP Slow-start Initial Value Can Be Changed

4054780 4057676

Non-Solaris clients may experience somewhat slower network performance on short-lived connections, such as http connections, when served by Solaris servers. This problem occurs because of Solaris' strict adherence to the TCP Slow-start specification (RFC2001). You can now modify the initial value that TCP Slow-start uses by tuning an ndd variable. For detailed information on how to modify this variable and an explanation of this behavior, go to the section titled "Sun Performance Information" under "Sun On the Net" at http://www.sun.com.

---

Solaris Bugs

xdm Does Not Have Executable Permissions

The execute bit for /usr/openwin/bin/xdm has been turned off.

Workaround: Become superuser and then type:

# chmod a+x /usr/openwin/bin/xdm

POSIX readdir_r Returns EINVAL When All Entries Have Been Read

4062296

int readdir_r(DIR *dirp, struct dirent *entry, struct dirent
**result);

The POSIX specification for readdir_r() does not clearly specify whether an end-of-file condition (EOF) should be treated as an error or as a successful operation.

The Solaris 2.6 implementation of readdir_r() in the POSIX environment handles EOF as an error condition. On EOF, readdir_r() returns EINVAL and sets *result to NULL.

A subsequent release of Solaris may change this behavior to be more consistent with other POSIX interfaces, such that on EOF, readdir_r() would return 0 and would set *result to NULL.

Workaround: Developers should write their applications to detect EOF by first checking whether *result is equal to NULL and then checking whether the return value is 0 or EINVAL. Applications written this way work in both cases.

---

Common Desktop Environment (CDE) Bugs

Displaying the dtfile Pop-Up Menu May Cause a Core Dump

4049745

If you display the dtfile pop-up menu, then the dtfile "File Select View" menu bar menus no longer function and may cause a core dump.

Workaround: Do not display the dtfile pop-up menu by clicking the mouse menu button over a file or folder icon. Also, do not display the dtfile pop-up menu by clicking the menu button over any part of the dtfile file and folder Viewing Area.

No Error or Warning Messages Are Generated if You Make an Illogical Selection in the CDE Calendar's Date Field4060832

If you make an illogical selection in a CDE Calendar's data field, such as selecting Leap Year 2/29 for a recurring yearly Calendar appointment, CDE ignores this information. In this example, the appointment is only scheduled in leap years (years that have a 2/29 date) on your Calendar.

---

Java Bugs

Applets That Export Java RMI Objects May Fail..4064085

Applets that export Java RMI objects may fail with a java.io.FileNotFoundException exception raised while loading the RMI skeleton class. This is due to an interaction between the Java RMI runtime and the use of RMI in HotJava for the Solaris operating environment which causes the wrong class loader to be used.

Workaround: Install the applets RMI skeleton class files locally and set the CLASSPATH environment variable to include them before starting HotJava.

---

AnswerBook2 Notes

Viewing Documents From a CD Is Not Available

The ab2_cd script, as documented in the "Installing Document Server Software" section of the AnswerBook2 Help, is not available in the Solaris_2.6_Doc directory on the Solaris 2.6 Documentation CD. The option to view the AnswerBook2 documents from the CD is not available.

Searching Japanese AnswerBook1 Documents

The SUNWjeuc and SUNWjiu8 packages located on the Japanese Solaris 2.6 CD are required to be installed on the server in order to search Japanese AnswerBook1 documents.

---

AnswerBook2 Bugs

ko Messages Display in English (En_US)......4065721

There is no support for Korean locale messages in the AnswerBook2 command line output or browser. When the AnswerBook2 language preference is set to Korean, the messages display as for the C locale.

Very Long Tables Are Slow To Display.......4064641

Some books, such as the MultiThreaded Programmers Guide, have tables that span over one hundred pages. These pages take longer than expected to load. You see a stalled message in the browser status bar until the page finally loads.

Workaround: Wait for the entire table to load. Do not interrupt the loading of a very long table.

Search Syntax Defaults to Literal Search......4065793

A default search that includes more than one word, such as the search does not have quotes, or the words AND and OR between search words, performs an exact search in some cases.

Workaround: Always specify the words AND or OR between search words to achieve this specific type of search.

Interbook Links Are Not Resolved Locally.....4066516

When following links to some book titles, the link is resolved to the http://docs.sun.com/ server rather than the local server. If http://docs.sun.com/ is not available or if the book does not exist there, an error is generated, even if the book is available on the local server.

Workaround: As root on the document server, edit the /var/log/ab2/catalog/ local.socat file and replace the entries containing the string dummy with the book identifier, as described in the following steps. As soon as you have edited the file, all links work locally. Therefore, there is no need to restart the server.

1. Find an entry containing the word dummy in the second field.

2. Find the book name in that entry.

   It is the string following the book= string.

3. Replace the dummy string (the word dummy) with the following text, substituting the book name for BOOKNAME below. Be sure to keep the entire entry on one line, and preserve capitalization, special characters, and spacing exactly as shown here:

"-//Sun::SunSoft//DOCUMENT BOOKNAME Version 1//EN"

Example of a corrected line:

PUBLIC "-//Sun::SunSoft//DOCUMENT BINARY Version 1/EN" "<dweb coll='coll.47.4' book='BINARY'>/opt/answerbooks/english/solaris_2.6/SUNWaadm/ books/BINARY</dweb>"

4. Repeat for all entries containing dummy in the second field.

5. Save the file.

---

AnswerBook2 Administration Bugs

answerbook2_admin Script Requires SUNWab2(r,s,u) Packages

4063836

If the AnswerBook2 software packages are not installed, running the answerbook2_admin script or selecting answerbook2_admin in the CDE system_admin panel fails.

Workaround: Install the SUNWab2(r,s,u) packages.

---

Documentation Collection Bugs

Solaris Internationalization Guide for Developers does not appear in the AnswerBook2 Library

4066791

The Solaris Internationalization Guide for Developers does not appear in the Solaris 2.6 Software Developer AnswerBook Vol 2 collection.

Workaround: To browse the book locally, enter the following URL, substituting the name of your documentation server for doc-server-name:

http://doc-server-name:8888/ab2/ @LegacyTocView?toc=SUNWab_124_1%3A%2Fopt%2Fanswerbooks%2Fenglish%2Fsolaris_2.6 %2FSUNWabdev%2Ftoc%2FI18N%3AI18N

You can also view and search this document at http://docs.sun.com.