Set untyped variable to int
[oweals/cde.git] / cde / README-2.1.30
1
2 **********************************************************************
3 NOTE: CDE/MOTIF IS LICENSED SOFTWARE.  SOURCE AND OBJECT CODE IS NOT
4 TO BE DISTRIBUTED TO THIRD PARTIES EXCEPT AS PROVIDED BY THE TERMS OF
5 YOUR LICENSE AGREEMENT.  PASSIVE DISTRIBUTION TO UNIDENTIFIED PARTIES,
6 SUCH AS MAKING FILES AVAILABLE FOR UNRESTRICTED ELECTRONIC FILE
7 TRANSFER, IS STRICTLY PROHIBITED BY THE LICENSE.
8
9 THESE RESTRICTIONS APPLY TO ANY PARTY TO WHOM THE SOFTWARE HAS BEEN
10 DISTRIBUTED.
11 **********************************************************************
12
13 THE PURPOSE OF THIS RELEASE
14
15         This is the third maintenance release for CDE and Motif 2.1.
16         It was designed to resolve as many defects as possible from the
17         project's defect database.  This maintenance release resolves 515
18         problem reports against CDE and Motif 2.1.20.
19
20
21         The Open Group encourages the reporting of all bugs found in CDE
22         and Motif regardless of the platform or hardware configuration in 
23         which the bug is found.  However, The Open Group will commit to 
24         accept (and repair according to priority) only those bugs that can 
25         be replicated on the current reference configurations.  
26
27
28 DOWNLOAD INSTRUCTIONS
29
30         This section describes how to unload the release archives
31         available at this ftp site.
32
33         The CDE/Motif 2.1.30 release is provided as compressed tar archives.  
34
35
36         README-2.1.30         - this file
37
38         cde.tar.Z             - a compressed tar file of the 
39                                 CDE 2.1.30 source code
40
41         cde-test.tar.Z        - a compressed tar file of the 
42                                 CDE 2.1.30 tests
43
44         cde-test-misc.tar.Z   - a compressed tar file of 
45                                 test results for CDE/Motif 2.1.30
46
47         motif.tar.Z           - a compressed tar file of the 
48                                 MOTIF 2.1.30 source code
49
50         motif-test-misc.tar.Z - a compressed tar file of 
51                                 test results for Motif 2.1.30
52
53
54         The CDE/Motif 2.1.30 release is in the form of a sparse tree; that 
55         is, it contains only files that have been modified in either CDE or 
56         Motif since the 2.1.20 release.  If you are a CDE licensee you will 
57         receive files for both CDE and Motif.  If you are a Motif-only 
58         licensee you will receive files just for Motif.
59
60         After ftp-ing the files to your machine, you should first uncompress
61         the compressed (*.Z) files with the command:
62         
63                 uncompress <filename>.Z
64         
65         Once the tar archives have been uncompressed, you can untar each
66         with the command:
67         
68                 tar xvf <filename>.tar
69         
70         This command will preserve the .tar file while unloading its contents
71         into your current working directory.  If you wish to list a table of
72         contents of the tar file before actually unloading it you can do so
73         with the command:
74         
75                 tar tvf <filename>.tar
76         
77
78 INSTALLING THIS RELEASE
79
80         This release is made up of a "sparse tree" of files that have changed
81         since release 2.1.20. The new versions of the files should replace the
82         corresponding CDE or Motif 2.1.20 versions of the files in your source 
83         tree. 
84
85
86         After the release is unloaded, you can use, for example, cp -R command
87         to copy the sources from the current directory into your source tree.
88         This release creates several new files.  If you are using a symbolic
89         link tree, you will need to create new links for them.
90
91         Please see the Release Notes from 2.1 for instructions on building
92         a full release tree.
93         
94
95 IMPORTANT CHANGES IN THIS RELEASE
96
97 Defect Repair
98
99         This patch release resolves 515 problem reports against CDE and 
100         Motif 2.1.20.  Each of these defects were resolved in one of three
101         ways: fixed (problem was recreated and repaired), duplicate 
102         (problem was already reported and recorded in defect database), 
103         or canceled (problem could not be recreated in current code
104         base).  The breakdown by component and resolution type is:
105
106 FIXED:          Total  370 
107
108         CDE Code:   95          Motif Code:  91
109         CDE Doc:     1          Motif Doc:    0
110         CDE Test:  110          Motif Test:  73
111         --------------          ---------------
112         Total:     206          Total:      164 
113
114 DUPLICATE:      Total  62 
115
116         CDE Code:   4           Motif Code:  10
117         CDE Doc:    0           Motif Doc:    0
118         CDE Test:  19           Motif Test:  29
119         --------------          ---------------
120         Total:     23           Total:       39 
121
122 CANCEL:         Total  83 
123
124         CDE Code:  18           Motif Code:  30
125         CDE Doc:    0           Motif Doc:    0
126         CDE Test:  13           Motif Test:  22
127         --------------          ---------------
128         Total:     31           Total:       52 
129
130
131         For more information on the bugs resolved, see the file 
132         CLOSEDBUGS in this release.
133
134         As of the completion of this maintenance release there are no
135         open defects against the CDE and Motif code and tests that have a
136         priority of 1 or a severity of 1.
137
138 Security
139         This release contains changes to address a number of security
140         vulnerabilities in CDE that were reported to CERT during 1999.
141         Those vulnerabilities are described in the CERT Advisory CA-99-11,
142         Four Vulnerabilities in the Common Desktop Environment.  A full
143         description can be found on the CERT Web site at
144         http://www.cert.org/advisories/CA-99-11-CDE.html.
145
146         A subset of those changes were released to the affected vendors
147         via the CERT working group formed to address the reported problems.
148         This release also includes additional changes to various CDE
149         desktop facilities to sense access violations and report them
150         to the user.
151
152 BUG LISTS
153
154         In the release archive there are two files, OPENBUGS and 
155         CLOSEDBUGS, which contain, respectively, the list of all bugs 
156         from any version of CDE or Motif not yet closed, and all bugs 
157         from CDE or Motif fixed in this patch release.
158
159
160 BUILDING MOTIF FOR YOUR SYSTEM
161
162         Since X11 is NOT being delivered as part of this release, there
163         are some minor changes in the build process for Motif with respect
164         to the build process described in the 2.1 Release Notes.
165
166         Replace step 2 under the Building Motif subsection of Section 3:
167
168           2.  If you are building with imports (the default setup in site.def),
169               construct the necessary links as follows:
170
171               % cd $CDEBUILDDIR/motif
172               % mkdir -p imports/x11
173               % cd imports/x11
174               % ln -s <X11_bin_directory> bin
175               % ln -s <X11_includes_directory> includes
176               % ln -s <X11_libs_directory> libs
177
178
179 REFERENCE PLATFORMS
180
181         The Open Group has used a number of platforms during the
182         development of the 2.1.30 release.  However, the following
183         reference platforms are the only ones where the complete
184         test cycle was run.  Test results appear below.
185
186
187    CDE and Motif:
188         HP9000/7xx running HP-UX 10.20
189         Sun SPARCstation running Solaris 2.4
190                 using the SC 4.0 C compiler and SC 4.1 C++ compilers
191
192         Note that the Validation Suite for Motif (VSM) was also run on a
193         Digital AlphaStation 200 running Digital UNIX 4.0D.  Results were
194         consistent with those on the reference platforms and are included
195         in the test results archives.
196
197    
198    Changes to X11R6.4:
199
200         CDE and Motif 2.1.30 have been built and tested upon a base of 
201         X11R6.4 patchlevel 3.  During the development of 2.1.20, a 
202         significant defect in the I18N code of X was discovered; if you have
203         not yet corrected this problem, you are advised to do so prior
204         to making use of 2.1.30.
205
206         The symptom is that when XMODIFIERS is not set, there is a possibility
207         of memory corruption.   It is recommended that the following patch 
208         be applied:
209
210         *** imInt.c@@/main/5       Sat May 30 21:04:36 1998
211         --- xc/lib/X11/imInt.c       Mon Aug 24 16:17:25 1998
212         ***************
213         *** 1,4 ****
214         ! /* $TOG: README-2.1.30 /main/1 1999/12/14 14:52:14 devobj $ */
215           /******************************************************************
216           
217                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
218         --- 1,4 ----
219         ! /* $TOG: README-2.1.30 /main/1 1999/12/14 14:52:14 devobj $ */
220           /******************************************************************
221           
222                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
223         ***************
224         *** 166,174 ****
225           _XimMakeImName(lcd)
226               XLCd         lcd;
227           {
228         !     char* begin;
229         !     char* end;
230         !     char* ret;
231               int       i = 0;
232               char* ximmodifier = XIMMODIFIER;
233           
234         --- 166,174 ----
235           _XimMakeImName(lcd)
236               XLCd         lcd;
237           {
238         !     char* begin = NULL;
239         !     char* end = NULL;
240         !     char* ret = NULL;
241               int       i = 0;
242               char* ximmodifier = XIMMODIFIER;
243           
244         ***************
245         *** 182,189 ****
246               }
247               ret = Xmalloc(end - begin + 2);
248               if (ret != NULL) {
249         !       (void)strncpy(ret, begin, end - begin + 1);
250         !       ret[end - begin + 1] = '\0';
251               }
252               return ret;
253           }
254         --- 182,192 ----
255               }
256               ret = Xmalloc(end - begin + 2);
257               if (ret != NULL) {
258         !       if (begin != NULL && end != NULL) {
259         !           (void)strncpy(ret, begin, end - begin + 1);
260         !           ret[end - begin + 1] = '\0';
261         !         }
262         !       else *ret = '\0';
263               }
264               return ret;
265           }
266
267
268 TEST RESULTS SUMMARY
269
270         Since this is a general availability release, it has undergone 
271         the full quality assurance cycle. The cycle includes running the
272         following test suites:
273
274                 QATS - Motif Quality Assurance Test Suite
275                 VSM 4.1  - Motif Validation Suite
276                 CDE Regression Tests
277
278         The results of these test runs can be found in the release
279         archive under cde-test-misc/reports/cde-2.1.30 and
280         motif-test-misc/reports/cde-2.1.30.