| 1 | File: pr/tests/readme
|
|---|
| 2 |
|
|---|
| 3 | This document describes the test cases in the NSPR directory
|
|---|
| 4 | pr/tests.
|
|---|
| 5 |
|
|---|
| 6 | =====================================================================
|
|---|
| 7 | There are some sub-directories here:
|
|---|
| 8 |
|
|---|
| 9 | dll
|
|---|
| 10 | sources for the .dll(.so) used by test dlltest.c
|
|---|
| 11 |
|
|---|
| 12 | macbuild
|
|---|
| 13 | MacIntosh project files
|
|---|
| 14 |
|
|---|
| 15 | server
|
|---|
| 16 | an empty directory. Does anyone remember why?
|
|---|
| 17 |
|
|---|
| 18 | w16gui
|
|---|
| 19 | Sources for a modified version of the poppad application from
|
|---|
| 20 | Charles Petzold's book "Programming Windows 3.1". These
|
|---|
| 21 | sources were modified to test the library lib/ds/PLEvent.
|
|---|
| 22 | These files are obsolete and will not be maintained.
|
|---|
| 23 |
|
|---|
| 24 | This test was superceded by lib/tests/windows/winevent.c and
|
|---|
| 25 | lib/event.c and is now owned by CPD.
|
|---|
| 26 |
|
|---|
| 27 | =====================================================================
|
|---|
| 28 | The individual files are described here.
|
|---|
| 29 |
|
|---|
| 30 | The script 'runtests.ksh' enumerates and runs test cases that are
|
|---|
| 31 | expected to run on all platforms.
|
|---|
| 32 |
|
|---|
| 33 |
|
|---|
| 34 | accept.c
|
|---|
| 35 | Tests PR_Accept() and related socket functions.
|
|---|
| 36 |
|
|---|
| 37 | acceptread.c
|
|---|
| 38 | Tests PR_AcceptRead()
|
|---|
| 39 |
|
|---|
| 40 | alarm.c
|
|---|
| 41 | Tests alarm functions declared in obsolete/pralarm.h.
|
|---|
| 42 | The alarm functions are obsolete, so is this test.
|
|---|
| 43 |
|
|---|
| 44 | atomic.c
|
|---|
| 45 | Tests Atomic operations defined in pratom.h
|
|---|
| 46 |
|
|---|
| 47 | attach.c
|
|---|
| 48 | Test PR_AttachThread()
|
|---|
| 49 | Note: This is an NSPR private function.
|
|---|
| 50 |
|
|---|
| 51 | bigfile.c
|
|---|
| 52 | Test 64bit file offset functions declared in prio.h
|
|---|
| 53 |
|
|---|
| 54 | bug1test.c
|
|---|
| 55 | Demonstrates a bug on NT.
|
|---|
| 56 |
|
|---|
| 57 | cleanup.c
|
|---|
| 58 | Tests PR_Cleanup() declared in prinit.h
|
|---|
| 59 |
|
|---|
| 60 | cltsrv.c
|
|---|
| 61 | Tests many socket functions.
|
|---|
| 62 |
|
|---|
| 63 | concur.c
|
|---|
| 64 | Tests threading functions and concurrent operations.
|
|---|
| 65 |
|
|---|
| 66 | cvar.c
|
|---|
| 67 | Tests condition variables.
|
|---|
| 68 |
|
|---|
| 69 | cvar2.c
|
|---|
| 70 | Tests condition variables. A rather abusive test.
|
|---|
| 71 |
|
|---|
| 72 | dbmalloc.c
|
|---|
| 73 | Obsolete. Originally for testing debug builds of NSPR's malloc.
|
|---|
| 74 |
|
|---|
| 75 | dbmalloc1.c
|
|---|
| 76 | Obsolete. Originally for testing debug builds of NSPR's malloc.
|
|---|
| 77 |
|
|---|
| 78 | dceemu.c
|
|---|
| 79 | Tests special functions for DCE emulation.
|
|---|
| 80 |
|
|---|
| 81 | depend.c
|
|---|
| 82 | Obsoltet. Tests early spec for library dependency.
|
|---|
| 83 |
|
|---|
| 84 | dlltest.c
|
|---|
| 85 | Tests dynamic library fucntions. Used with dll/my.c
|
|---|
| 86 |
|
|---|
| 87 | dtoa.c
|
|---|
| 88 | Tests conversions of double to string.
|
|---|
| 89 |
|
|---|
| 90 | exit.c
|
|---|
| 91 | Tests PR_ProcessExit() declared in prinit.h
|
|---|
| 92 |
|
|---|
| 93 | fileio.c
|
|---|
| 94 | Tests NSPR semaphores a bit of file i/o and threading
|
|---|
| 95 | functions.
|
|---|
| 96 |
|
|---|
| 97 | foreign.c
|
|---|
| 98 | Test auto-attach of a thread created by something other than
|
|---|
| 99 | NSPR.
|
|---|
| 100 |
|
|---|
| 101 | forktest.c
|
|---|
| 102 | Limited use. Tests unix fork() and related functions.
|
|---|
| 103 |
|
|---|
| 104 | fsync.c
|
|---|
| 105 | Tests use of PR_Sync() declared in prio.h
|
|---|
| 106 |
|
|---|
| 107 | getproto.c
|
|---|
| 108 | Tests socket functions PR_GetProtoByName(), etc.
|
|---|
| 109 |
|
|---|
| 110 | i2l.c
|
|---|
| 111 | Tests LongLong functions for converting 32bit integer to 64bit
|
|---|
| 112 | integer.
|
|---|
| 113 |
|
|---|
| 114 | initclk.c
|
|---|
| 115 | Tests timing on minimal use of condition variable
|
|---|
| 116 |
|
|---|
| 117 | inrval.c
|
|---|
| 118 | Tests interval timing functions.
|
|---|
| 119 |
|
|---|
| 120 | instrumt.c
|
|---|
| 121 | Tests instrumentation functions. prcountr.h prtrace.h
|
|---|
| 122 |
|
|---|
| 123 | intrupt.c
|
|---|
| 124 | Tests PR_Interrupt()
|
|---|
| 125 |
|
|---|
| 126 | ioconthr.c
|
|---|
| 127 | Tests i/o continuation mechanism in pthreads.
|
|---|
| 128 |
|
|---|
| 129 | io_timeout.c
|
|---|
| 130 | Test socket i/o timeouts.
|
|---|
| 131 |
|
|---|
| 132 | io_timeoutk.c
|
|---|
| 133 | Obsolete. Subsumed in io_timeout.c
|
|---|
| 134 |
|
|---|
| 135 | io_timeoutu.c
|
|---|
| 136 | Obsolete. Subsumed in io_timeout.c
|
|---|
| 137 |
|
|---|
| 138 | ipv6.c
|
|---|
| 139 | Tests IPv6. IPv6 is not used by NSPR clients.
|
|---|
| 140 |
|
|---|
| 141 | join.c
|
|---|
| 142 | Tests PR_JoinThread()
|
|---|
| 143 |
|
|---|
| 144 | joinkk.c
|
|---|
| 145 | Tests PR_JoinThread()
|
|---|
| 146 |
|
|---|
| 147 | joinku.c
|
|---|
| 148 | Tests PR_JoinThread()
|
|---|
| 149 |
|
|---|
| 150 | joinuk.c
|
|---|
| 151 | Tests PR_JoinThread()
|
|---|
| 152 |
|
|---|
| 153 | joinuu.c
|
|---|
| 154 | Tests PR_JoinThread()
|
|---|
| 155 |
|
|---|
| 156 | layer.c
|
|---|
| 157 | Tests layered I/O.
|
|---|
| 158 |
|
|---|
| 159 | lazyinit.c
|
|---|
| 160 | Tests implicit initialization.
|
|---|
| 161 |
|
|---|
| 162 | lltest.c
|
|---|
| 163 | Tests LongLong (64bit integer) arithmentic and conversions.
|
|---|
| 164 |
|
|---|
| 165 | lock.c
|
|---|
| 166 | Tests PR_Lock() in heavily threaded environment.
|
|---|
| 167 |
|
|---|
| 168 | lockfile.c
|
|---|
| 169 | Test PR_Lockfile().
|
|---|
| 170 |
|
|---|
| 171 | logger.c
|
|---|
| 172 | Tests PR_LOG()
|
|---|
| 173 |
|
|---|
| 174 | makefile
|
|---|
| 175 | The makefile that builds all the tests
|
|---|
| 176 |
|
|---|
| 177 | many_cv.c
|
|---|
| 178 | Tests aquiring a large number of condition variables.
|
|---|
| 179 |
|
|---|
| 180 | multiwait.c
|
|---|
| 181 | ???
|
|---|
| 182 |
|
|---|
| 183 | nbconn.c
|
|---|
| 184 | Test non-blocking connect.
|
|---|
| 185 |
|
|---|
| 186 | nblayer.c
|
|---|
| 187 | Tests NSPR's layered I/O capability.
|
|---|
| 188 |
|
|---|
| 189 | nonblock.c
|
|---|
| 190 | Tests operations on non-blocking socket.
|
|---|
| 191 |
|
|---|
| 192 | op_2long.c
|
|---|
| 193 | Tests PR_Open() where filename is too long.
|
|---|
| 194 |
|
|---|
| 195 | op_filnf.c
|
|---|
| 196 | Tests PR_Open() where filename is NotFound.
|
|---|
| 197 |
|
|---|
| 198 | op_filok.c
|
|---|
| 199 | Tests PR_Open() where filename is accessable.
|
|---|
| 200 |
|
|---|
| 201 | op_noacc.c
|
|---|
| 202 | Tests PR_Open() where file permissions are wrong.
|
|---|
| 203 | Limited use. Windows has no concept of Unix style file permissions.
|
|---|
| 204 |
|
|---|
| 205 | op_nofil.c
|
|---|
| 206 | Tests PR_Open() where filename does not exist.
|
|---|
| 207 |
|
|---|
| 208 | parent.c
|
|---|
| 209 | Test parent/child process capability
|
|---|
| 210 |
|
|---|
| 211 | perf.c
|
|---|
| 212 | Tests and measures context switch times for various thread
|
|---|
| 213 | syncronization functions.
|
|---|
| 214 |
|
|---|
| 215 | pipeping.c
|
|---|
| 216 | Tests inter-process pipes. Run with pipepong.c
|
|---|
| 217 |
|
|---|
| 218 | pipepong.c
|
|---|
| 219 | Tests inter-process pipes. Run with pipeping.c
|
|---|
| 220 |
|
|---|
| 221 | pipeself.c
|
|---|
| 222 | Tests inter-thread pipes.
|
|---|
| 223 |
|
|---|
| 224 | pollable.c
|
|---|
| 225 | Tests pollable events. prio.h
|
|---|
| 226 |
|
|---|
| 227 | poll_er.c
|
|---|
| 228 | Tests PR_Poll() where an error is expected.
|
|---|
| 229 |
|
|---|
| 230 | poll_nm.c
|
|---|
| 231 | Tests PR_Poll() where normal operation is expected.
|
|---|
| 232 |
|
|---|
| 233 | poll_to.c
|
|---|
| 234 | Tests PR_Poll() where timeout is expected.
|
|---|
| 235 |
|
|---|
| 236 | prftest.c
|
|---|
| 237 | Tests printf-like formatting.
|
|---|
| 238 |
|
|---|
| 239 | prftest1.c
|
|---|
| 240 | Obsolete. Subsumed in prftest.c
|
|---|
| 241 |
|
|---|
| 242 | prftest2.c
|
|---|
| 243 | Obsolete. Subsumed in prftest.c
|
|---|
| 244 |
|
|---|
| 245 | priotest.c
|
|---|
| 246 | Limited use. Tests NSPR thread dispatching priority.
|
|---|
| 247 |
|
|---|
| 248 | provider.c
|
|---|
| 249 |
|
|---|
| 250 | prpoll.c
|
|---|
| 251 | Tests PR_Poll().
|
|---|
| 252 |
|
|---|
| 253 | prselect.c
|
|---|
| 254 | Obsolete. PR_Select() is obsolete.
|
|---|
| 255 |
|
|---|
| 256 | prttools.h
|
|---|
| 257 | Unused file.
|
|---|
| 258 |
|
|---|
| 259 | ranfile.c
|
|---|
| 260 | Tests random file access.
|
|---|
| 261 |
|
|---|
| 262 | readme
|
|---|
| 263 | This file.
|
|---|
| 264 |
|
|---|
| 265 | runtests.ksh
|
|---|
| 266 | A korn shell script that runs a set of tests that should run
|
|---|
| 267 | on any of the NSPR supported platforms.
|
|---|
| 268 |
|
|---|
| 269 | runtests.pl
|
|---|
| 270 | A perl script to run the test cases. This srcipt runs tests
|
|---|
| 271 | common to all platforms and runs tests applicable to specific
|
|---|
| 272 | platforms. Uses file runtests.txt to control execution.
|
|---|
| 273 |
|
|---|
| 274 | runtests.txt
|
|---|
| 275 | Control file for perl script: runtests.pl
|
|---|
| 276 |
|
|---|
| 277 | rwlocktest.c
|
|---|
| 278 | Tests Reader/Writer lock
|
|---|
| 279 |
|
|---|
| 280 | selct_er.c
|
|---|
| 281 | Obsolete. PR_Select() is obsolete.
|
|---|
| 282 |
|
|---|
| 283 | selct_nm.c
|
|---|
| 284 | Obsolete. PR_Select() is obsolete.
|
|---|
| 285 |
|
|---|
| 286 | selct_to.c
|
|---|
| 287 | Obsolete. PR_Select() is obsolete.
|
|---|
| 288 |
|
|---|
| 289 | select2.c
|
|---|
| 290 | Obsolete. PR_Select() is obsolete.
|
|---|
| 291 |
|
|---|
| 292 | sel_spd.c
|
|---|
| 293 | Obsolete. PR_Select() is obsolete.
|
|---|
| 294 |
|
|---|
| 295 | sem.c
|
|---|
| 296 | Obsolete. Semaphores are not supported.
|
|---|
| 297 |
|
|---|
| 298 | server_test.c
|
|---|
| 299 | Tests sockets by simulating a server in loopback mode.
|
|---|
| 300 | Makes its own client threads.
|
|---|
| 301 |
|
|---|
| 302 | servr_kk.c
|
|---|
| 303 | Tests client/server sockets, threads using system threads.
|
|---|
| 304 |
|
|---|
| 305 | servr_ku.c
|
|---|
| 306 | Tests client/server sockets, threads using system and user threads.
|
|---|
| 307 |
|
|---|
| 308 | servr_uk.c
|
|---|
| 309 | Tests client/server sockets, threads using system and user threads.
|
|---|
| 310 |
|
|---|
| 311 | servr_uu.c
|
|---|
| 312 | Tests client/server sockets, threads user threads.
|
|---|
| 313 |
|
|---|
| 314 | short_thread.c
|
|---|
| 315 | Tests short-running threads. Useful for testing for race conditions.
|
|---|
| 316 |
|
|---|
| 317 | sigpipe.c
|
|---|
| 318 | Tests NSPR's SIGPIPE handler. Unix only.
|
|---|
| 319 |
|
|---|
| 320 | sleep.c
|
|---|
| 321 | Limited use. Tests sleep capability of platform.
|
|---|
| 322 |
|
|---|
| 323 | socket.c
|
|---|
| 324 | Tests many socket functions.
|
|---|
| 325 |
|
|---|
| 326 | sockopt.c
|
|---|
| 327 | Tests setting and getting socket options.
|
|---|
| 328 |
|
|---|
| 329 | sprintf.c
|
|---|
| 330 | Tests sprintf.
|
|---|
| 331 |
|
|---|
| 332 | sproc_ch.c
|
|---|
| 333 | Obsolete. Tests IRIX sproc-based threads.
|
|---|
| 334 |
|
|---|
| 335 | sproc_p.c
|
|---|
| 336 | Obsolete. Tests IRIX sproc-based threads.
|
|---|
| 337 |
|
|---|
| 338 | stack.c
|
|---|
| 339 | Test atomic stack operations.
|
|---|
| 340 |
|
|---|
| 341 | stat.c
|
|---|
| 342 | Tests performance of getfileinfo() vs. stat()
|
|---|
| 343 |
|
|---|
| 344 | stdio.c
|
|---|
| 345 | Tests NSPR's handling of stdin, stdout, stderr.
|
|---|
| 346 |
|
|---|
| 347 | strod.c
|
|---|
| 348 | Tests formatting of double precision floating point.
|
|---|
| 349 |
|
|---|
| 350 | suspend.c
|
|---|
| 351 | Private interfaces PR_SuspendAll(), PR_ResumeAll(), etc.
|
|---|
| 352 |
|
|---|
| 353 | switch.c
|
|---|
| 354 | Tests thread switching
|
|---|
| 355 |
|
|---|
| 356 | system.c
|
|---|
| 357 | Tests PR_GetSystemInfo()
|
|---|
| 358 |
|
|---|
| 359 | testbit.c
|
|---|
| 360 | Tests bit arrays.
|
|---|
| 361 |
|
|---|
| 362 | testfile.c
|
|---|
| 363 | Tests many file I/O functions.
|
|---|
| 364 |
|
|---|
| 365 | threads.c
|
|---|
| 366 | Tests thread caching.
|
|---|
| 367 |
|
|---|
| 368 | thruput.c
|
|---|
| 369 | Tests socket thruput. Must be run by hand as client/server.
|
|---|
| 370 | Does not self terminate.
|
|---|
| 371 |
|
|---|
| 372 | time.c
|
|---|
| 373 | Incomplete. Limited use.
|
|---|
| 374 |
|
|---|
| 375 | timemac.c
|
|---|
| 376 | Test time and date functions. Originally for Mac.
|
|---|
| 377 |
|
|---|
| 378 | timetest.c
|
|---|
| 379 | Tests time conversion over a wide range of dates.
|
|---|
| 380 |
|
|---|
| 381 | tmoacc.c
|
|---|
| 382 | Server to tmocon.c and writev.c
|
|---|
| 383 | Do not run it by itself.
|
|---|
| 384 |
|
|---|
| 385 | tmocon.c
|
|---|
| 386 | Client thread to tmoacc.c
|
|---|
| 387 |
|
|---|
| 388 | tpd.c
|
|---|
| 389 | Tests thread private data.
|
|---|
| 390 |
|
|---|
| 391 | udpsrv.c
|
|---|
| 392 | Tests UDP socket functions.
|
|---|
| 393 |
|
|---|
| 394 | ut_ttools.h
|
|---|
| 395 | unused file.
|
|---|
| 396 |
|
|---|
| 397 | version.c
|
|---|
| 398 | Extract and print library version data.
|
|---|
| 399 |
|
|---|
| 400 | vercheck.c
|
|---|
| 401 | Test PR_VersionCheck().
|
|---|
| 402 |
|
|---|
| 403 | writev.c
|
|---|
| 404 | Tests gather-write on a socket. Requires tmoacc.c
|
|---|
| 405 |
|
|---|
| 406 | xnotify.c
|
|---|
| 407 | Tests cached monitors.
|
|---|
| 408 |
|
|---|
| 409 | yield.c
|
|---|
| 410 | Limited use
|
|---|
| 411 |
|
|---|
| 412 | y2k.c
|
|---|
| 413 | Test to verify NSPR's date functions as Y2K compliant.
|
|---|
| 414 |
|
|---|
| 415 | dll\Makefile
|
|---|
| 416 | makefile for mygetval.c, mysetval.c
|
|---|
| 417 |
|
|---|
| 418 | dll\mygetval.c
|
|---|
| 419 | Dynamic library test. See also dlltest.c
|
|---|
| 420 |
|
|---|
| 421 | dll\mysetval.c
|
|---|
| 422 | Dynamic library test. See also dlltest.c
|
|---|
| 423 |
|
|---|
| 424 | w16gui\Makefile
|
|---|
| 425 | Obsolete. Tests for lib/ds/PLEvent on Windows 3.1.
|
|---|
| 426 | w16gui\popfile.c
|
|---|
| 427 | w16gui\popfind.c
|
|---|
| 428 | w16gui\popfont.c
|
|---|
| 429 | w16gui\poppad.c
|
|---|
| 430 | w16gui\poppad.h
|
|---|
| 431 | w16gui\poppad.ico
|
|---|
| 432 | w16gui\poppad.rc
|
|---|
| 433 | w16gui\popprnt0.c
|
|---|
| 434 | w16gui\readme.1st
|
|---|
