CHAPTER 3

Late-Breaking Solaris Runtime Bugs

---

---

Operating System Bugs

Scoped Libraries in Solaris

As part of an effort to refine the API that the Solaris operating environment exposes in shared libraries, a number of previously undocumented yet visible interfaces have been reduced to local scope and are, therefore, no longer visible to the application. If applications have dependencies on the interfaces that are no longer visible due to the scoping of the libraries, the applications encounter the following error:

ld.so.1: bar: fatal: relocation error: file /usr/lib/libfoo.so.1: symbol foobar: referenced symbol not found

---

Desktop Bugs

Date Prompt String Uses LC_MESSAGES When It Should Use LC_TIME

4053983

If your system's LC_TIME environment variable is set to a locale different from the locale that is set in the LC_MESSAGES environment variable, then the date prompt displays a format that is not compatible with what the CDE Mailer expects.

Workaround: Before you start your vacation mail, make sure that your system's LC_MESSAGES and LC_TIME environment variables are set to the same locale.

---

System Administration Bugs

Network Bugs

SPARC only: Using DECnet: Cannot Open Display 4032010

Support for a DECnet network connection for remote X Window clients, i.e., running an X Window program on a remote host with the output sent to the local machine to display through DECnet, is not available in Solaris 2.6. Other network functions do work and local clients are not affected by this.

Workaround: Do not use a DECnet network connection in X Window to gain access to the local display from another host.

Using /etc/defaultrouter With Diskless Clients and Solstice AutoClients

4053747

If /etc/defaultrouter (see defaultrouter(4)) file exists in the root file system of a diskless or Solstice AutoClient system, the client may hang. A defaultrouter file is usually not created for diskless or AutoClient systems because it is not required.

Workaround: If this problem occurs, the root file system administrator must remove the /etc/defaultrouter file from the root file systems on the diskless or Solstice AutoClient system and reboot the client. If the administrator wants to add additional default routes, this task can be accomplished using router discovery advertisements. See in.rdisc(1M) and RFC 1256 for more information.

Port Number 161 is Already Used by Another Agent

By default the Solstice Enterprise Agents (SEA) Master Agent runs on port 161. If port 161 is already occupied by some other SNMP agent, the SEA Master Agent displays the following error message in the syslog and then subsequently exits:

snmpdx: bind() failed on UDP port 161 [errno: Address already in use(125)]

Workaround: The already present SNMP agent can be configured as a legacy agent of the SEA Master Agent. This eliminates the conflict for UDP port 161.

Solstice Enterprise Agents 1.0.1

The Master Agent maintains a table of its subagents. This table contains information such as the port number for the subagent and the MIB variables that the subagent manages. When the Master Agent detects that a subagent is not responding, it deletes the subagent's entry from this table and logs a message via syslog noting that the subagent has been deleted from its table. You can issue a SIGHUP signal to the Master Agent (snmpdx) to make it restart the subagent.

Linking With libsocket No Bug ID

Applications that have statically linked with libsocket do not work with the Solaris 2.6 operating environment because of changes in the socket implementation.

Listing the dynamic dependencies of the application binary with /usr/bin/ldd enables you to evaluate whether or not your application is statically linked with libsocket. If libsocket.so.1 is not listed and your application uses sockets, then your application must be statically linked.

Workaround: Recompile and dynamically link with libsocket.

Stack Overflow............4015478, 4015480, 4015481

NFS servers using Solstice DiskSuite may crash with a stack overflow.

Workaround: Add the following line to /etc/system:

set rpcmod:svc_run_stksize=0x4000

Then reboot the server.

File Systems/Solstice DiskSuite Bugs

getmntent(3C) Interface..................4013162

The getmntent(3C) interface is designed to enable applications to read the /etc/mnttab file to obtain information on currently mounted file systems. However, this file can get modified while an application is reading it. This can be a problem for some applications.

Workaround: Apply the same locking as the system utilities. After the /etc/ mnttab file has been opened using fopen(3S), then a read lock should be applied to this file. The read lock blocks other processes that want to update this file because they apply a write lock before doing so. This read lock, F_RDLCK, should be applied using fcntl(2) with the F_SETLKW argument.

Negative size values reported for the size of meta devices over 1 TB

4054815

If a meta device exceeds 1 TB in size, the metastat command and metatool graphical user interface (GUI) report negative size values for the size of meta devices. This occurs because of a problem in the copackaged Solstice DiskSuite (SDS) 4.1 product.

Workaround:

On SPARC Platforms

· Install Solstice DiskSuite patch 104172-07.

On x86 Platforms:

· Install Solstice DiskSuite patch 104173-07.

Graphics --------

Operation is not implemented............. 1245393

The photo CD I/O device does not support an xil_get_pixel operation.

Workaround: If you need to obtain the value for a particular pixel of a photo CD image, copy the photo CD image to a memory image and then call xil_get_pixel on the memory image.

x86 only: ld.so.1: imagetool: fatal: relocation error: file /usr/openwin/lib/xil/devhandlers/ xilIO_SUNWp9100.so.2: symbol

__0fIXilImageKgetStorageP6KXilStorageP6FXilOpP6GXilBox Pc6S __XilStorageAccess6OXilStorageTypePv: referenced symbol not found 4014421

On systems that have a p9000- or p9100-based video card, Image Tool fails when it tries to use the corresponding XIL pipeline. The pipelines fail to resolve some symbols in the XIL library.

Workaround: Set the environment variable XIL_DISPLAY to ioxlib before running OpenWindows, as shown in the following example:

C-Shell Environment

% setenv XIL_DISPLAY ioxlib

Bourne/Korn Shell Environment

$ XIL_DISPLAY=ioxlib;export XIL_DISPLAY

XGL Bugs

Window Size Returned by DGA Behind by One Resize Event

1183134

With XView and possibly other toolkits calling the application's resize_proc() before sending the resize request to the server, the window size returned by DGA is behind by one resize event.

Workaround: Calling XSync() before calling xgl_window_raster_resize() fixes the problem.

Gcache decomp Does Edges Incorrectly for gcache_multi_simple_polygon

1167214

When an XGL Gcache decomposes a polygon with edges, some edges are rendered incorrectly for xgl_gcache_multi_simple_polygon().

Workaround: Set the XGL_GCACHE_USE_APPL_GEOM to TRUE. Alternately, use xgl_gcache_polygon() instead of xgl_gcache_multi_simple_polygon() and turn off XGL_GCACHE_SHOW_DECOMP_EDGES when creating the GCACHE context.

The Threshold Value XGL_CTX_THRESHOLD is Ignored

1183758

End-Points Are Wrong...................1122199

When XGL is drawing wide lines with round joins and depth-queuing is on, the round joins are the wrong color.

PEX Bugs

Primitives Are Not Always Rendered Properly After Window Resizes

1185730

When a window being rendered into is resized and the corresponding viewport is adjusted, primitives may be rendered incorrectly or not at all.

x86 only: Polygon Anti-Aliasing Attributes Are Ignored When Traversing Structures on the x86 P9000

1191342

Polygon anti-aliasing attributes set in structures are ignored when those structures are traversed on the x86 P9000.

Java Virtual Machine Bugs

This section documents bugs in the Java Virtual Machine software that were known at the time of publication.

Signals in Native Methods

Native methods or code should not use the SIGUSR1 signal. The current version of the JVM on Solaris reserves use of this signal to implement the interrupt method in the Threads class.

Applet Background Color Incorrect on Reload..4035722

When navigating in the HotJava browser to a page containing an applet using the 'back' button, applets, which set their background, may not have that background color properly restored when returning to the page containing that applet.

Workaround: If the background color is incorrect, reload the page with the reload button.

Java Applications Exit Abnormally When Insufficient Swap Space Is Available

4037312

HotJava and other Java applications dump core when there is not enough swap space. The application indicates the following bus error:

not enough space

Workaround: Exit other applications running on the system or add more swap space. See the System Administrators Guide for details on adding swap space.

Java Thread.suspend() May Cause Applications To Hang

4040218

The Java Thread.suspend() method may cause Java application programs to hang. The suspend() and resume() methods should not be used.

Hangs may occur because a thread holding a lock is suspended and the thread responsible for resuming this thread needs this lock. This is a general problem with threaded programming because of improper usage of these primitives, which lead to application deadlocks. These methods are under review by JavaSoft.

Workaround: Use other appropriate synchronization methods, such as wait() and notify().

Timestamp Constructor Accepts Two-Digit Date..4047499

java.sql.Timestamp constructor accepts two-digit date that is interpreted as 19XX.

Workaround: Use a four-digit year when calling the constructor java.sql.TimeStamp(int,int....

Java Application Can Hang During Socket accept()

4055180

If a thread is blocked in an operation on a file descriptor, such as accept(), receive(), etc., and another thread attempts to close the file descriptor, the application hangs. A debugger cannot be attached to the hung application.

Workaround: A thread should not close a file descriptor that is in use. If necessary, the blocking operation should be interrupted, and then the fd should be closed.

Documentation Errata

Book Affected: AnswerBook2 -- Accessing Online Documentation

This information only applies if you want to set up or administer AnswerBook2 server software on your desktop. If you only want to view documentation, then you do not need to read this.

The AnswerBook2 server software is now located on the Solaris Documentation CD, along with the document collections. It is no longer located on the Solaris Product CD.

Book Affected: AnswerBook2 -- Display of man Pages

Some man pages do not display properly.

Workaround: If you are unable to displaying a man page in AnswerBook2, use the man command in a shell window.

x86 only: man Pages

These man pages are out-of-date in the Solaris 2.6 AnswerBook2 or they are missing from that book altogether. The correct entries are available in the online man pages:

· smart2cfg(1)
· fdisk(1M)
· adp(7D)
· cnft(7D)
· cpqncr(7D)
· csa(7D)
· flashpt(7d)
· pcata(7D)
· smartii(7D)
· trantor(7D)

Errata in the SunVideo User's Manual

With Solaris 2.6, certain pages of the SunVideo User's Manual need to be corrected. If you are using SunVideo, then note the following changes to the manual:

• page. 9 change

  /opt/SUNWits/Graphics-sw/xil/man to /opt/SUNWrtvc/man
· page 10 change

  /opt/SUNWits/Graphics-sw/xil and /etc/opt/SUNWrtvc to /opt/
  SUNWrtvc
· page 10 change

  /opt/SUNWits/Graphics-sw/xil/man/man3 to /opt/SUNWrtvc/man/man3

· p age 14 change

/etc/opt/SUNWrtvc/bin/rtvc-verify to /opt/SUNWrtv/bin/rtvc-
verify
·  page 14 change

/opt/SUNWits/Graphics-sw/xil/examples/test to /opt/SUNWrtvc/
examples/test

• page 19 change

/opt/SUNWits/Graphics]-sw/xil/examples/test/SunVideo to
/opt/SUNWrtvc/examples/test/SunVideo
· page 33 change

/opt/SUNWits/Graphics-sw/xil/examples/rtvcdisplay to
/opt/SUNWrtvc/examples/rtvcdisplay

Other Bugs

SPARC only: Ergonomics Standards - Compliance with ZH/ 618 and EN29241-3

For your Sun workstation to comply with ergonomics standards ZH/618 and EN29241-3 (ISO 9241-3), add or modify the following lines in the .OWdefaults file located in your home directory as follows:

Text.LineSpacing: 15 OpenWindows.Scale: large

These characteristics will take effect the next time you restart your OpenWindows environment.

ipRouteProto Variable Returns Other..........4053705

The kernel does not adequately support the SNMP MIB-II variable, ipRouteProto. As a result, the agent, mibiisa, always returns the value, 1 (which represents "other"), when queried for this variable.

SPARC only: 2.5.1 SUNWxntp Package Is Incompatible With Solaris 2.6

4061948

Some Solaris 2.5.1 Hardware releases contain an NTP package, SUNWxntp, for Ultra Enterprise 10000 platform support. The NTP software in the 2.5.1 SUNWxntp package is incompatible with the Solaris 2.6 environment and should not be installed on a Solaris 2.6 system. Upgrades from Solaris 2.5.1 systems that contain SUNWxntp are handled automatically. If you need NTP support for the Solaris 2.6 environment, install the SUNWntpr and SUNWntpu packages from the Solaris 2.6 CD.