1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/nsprpub/pr/tests/README.TXT Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,407 @@
1.4 +File: pr/tests/readme
1.5 +
1.6 +This document describes the test cases in the NSPR directory
1.7 +pr/tests.
1.8 +
1.9 +=====================================================================
1.10 +There is a sub-directory here:
1.11 +
1.12 +dll
1.13 + sources for the .dll(.so) used by test dlltest.c
1.14 +
1.15 +=====================================================================
1.16 +The individual files are described here.
1.17 +
1.18 +The script 'runtests.ksh' enumerates and runs test cases that are
1.19 +expected to run on all platforms.
1.20 +
1.21 +
1.22 +accept.c
1.23 + Tests PR_Accept() and related socket functions.
1.24 +
1.25 +acceptread.c
1.26 + Tests PR_AcceptRead()
1.27 +
1.28 +alarm.c
1.29 + Tests alarm functions declared in obsolete/pralarm.h.
1.30 + The alarm functions are obsolete, so is this test.
1.31 +
1.32 +atomic.c
1.33 + Tests Atomic operations defined in pratom.h
1.34 +
1.35 +attach.c
1.36 + Test PR_AttachThread()
1.37 + Note: This is an NSPR private function.
1.38 +
1.39 +bigfile.c
1.40 + Test 64bit file offset functions declared in prio.h
1.41 +
1.42 +bug1test.c
1.43 + Demonstrates a bug on NT.
1.44 +
1.45 +cleanup.c
1.46 + Tests PR_Cleanup() declared in prinit.h
1.47 +
1.48 +cltsrv.c
1.49 + Tests many socket functions.
1.50 +
1.51 +concur.c
1.52 + Tests threading functions and concurrent operations.
1.53 +
1.54 +cvar.c
1.55 + Tests condition variables.
1.56 +
1.57 +cvar2.c
1.58 + Tests condition variables. A rather abusive test.
1.59 +
1.60 +dbmalloc.c
1.61 + Obsolete. Originally for testing debug builds of NSPR's malloc.
1.62 +
1.63 +dbmalloc1.c
1.64 + Obsolete. Originally for testing debug builds of NSPR's malloc.
1.65 +
1.66 +dceemu.c
1.67 + Tests special functions for DCE emulation.
1.68 +
1.69 +depend.c
1.70 + Obsoltet. Tests early spec for library dependency.
1.71 +
1.72 +dlltest.c
1.73 + Tests dynamic library functions. Used with dll/my.c
1.74 +
1.75 +dtoa.c
1.76 + Tests conversions of double to string.
1.77 +
1.78 +exit.c
1.79 + Tests PR_ProcessExit() declared in prinit.h
1.80 +
1.81 +fileio.c
1.82 + Tests NSPR semaphores a bit of file i/o and threading
1.83 + functions.
1.84 +
1.85 +foreign.c
1.86 + Test auto-attach of a thread created by something other than
1.87 + NSPR.
1.88 +
1.89 +forktest.c
1.90 + Limited use. Tests unix fork() and related functions.
1.91 +
1.92 +fsync.c
1.93 + Tests use of PR_Sync() declared in prio.h
1.94 +
1.95 +getproto.c
1.96 + Tests socket functions PR_GetProtoByName(), etc.
1.97 +
1.98 +i2l.c
1.99 + Tests LongLong functions for converting 32bit integer to 64bit
1.100 + integer.
1.101 +
1.102 +initclk.c
1.103 + Tests timing on minimal use of condition variable
1.104 +
1.105 +inrval.c
1.106 + Tests interval timing functions.
1.107 +
1.108 +instrumt.c
1.109 + Tests instrumentation functions. prcountr.h prtrace.h
1.110 +
1.111 +intrupt.c
1.112 + Tests PR_Interrupt()
1.113 +
1.114 +ioconthr.c
1.115 + Tests i/o continuation mechanism in pthreads.
1.116 +
1.117 +io_timeout.c
1.118 + Test socket i/o timeouts.
1.119 +
1.120 +io_timeoutk.c
1.121 + Obsolete. Subsumed in io_timeout.c
1.122 +
1.123 +io_timeoutu.c
1.124 + Obsolete. Subsumed in io_timeout.c
1.125 +
1.126 +ipv6.c
1.127 + Tests IPv6. IPv6 is not used by NSPR clients.
1.128 +
1.129 +join.c
1.130 + Tests PR_JoinThread()
1.131 +
1.132 +joinkk.c
1.133 + Tests PR_JoinThread()
1.134 +
1.135 +joinku.c
1.136 + Tests PR_JoinThread()
1.137 +
1.138 +joinuk.c
1.139 + Tests PR_JoinThread()
1.140 +
1.141 +joinuu.c
1.142 + Tests PR_JoinThread()
1.143 +
1.144 +layer.c
1.145 + Tests layered I/O.
1.146 +
1.147 +lazyinit.c
1.148 + Tests implicit initialization.
1.149 +
1.150 +lltest.c
1.151 + Tests LongLong (64bit integer) arithmentic and conversions.
1.152 +
1.153 +lock.c
1.154 + Tests PR_Lock() in heavily threaded environment.
1.155 +
1.156 +lockfile.c
1.157 + Test PR_Lockfile().
1.158 +
1.159 +logger.c
1.160 + Tests PR_LOG()
1.161 +
1.162 +makefile
1.163 + The makefile that builds all the tests
1.164 +
1.165 +many_cv.c
1.166 + Tests aquiring a large number of condition variables.
1.167 +
1.168 +multiwait.c
1.169 + ???
1.170 +
1.171 +nbconn.c
1.172 + Test non-blocking connect.
1.173 +
1.174 +nblayer.c
1.175 + Tests NSPR's layered I/O capability.
1.176 +
1.177 +nonblock.c
1.178 + Tests operations on non-blocking socket.
1.179 +
1.180 +op_2long.c
1.181 + Tests PR_Open() where filename is too long.
1.182 +
1.183 +op_filnf.c
1.184 + Tests PR_Open() where filename is NotFound.
1.185 +
1.186 +op_filok.c
1.187 + Tests PR_Open() where filename is accessable.
1.188 +
1.189 +op_noacc.c
1.190 + Tests PR_Open() where file permissions are wrong.
1.191 + Limited use. Windows has no concept of Unix style file permissions.
1.192 +
1.193 +op_nofil.c
1.194 + Tests PR_Open() where filename does not exist.
1.195 +
1.196 +parent.c
1.197 + Test parent/child process capability
1.198 +
1.199 +perf.c
1.200 + Tests and measures context switch times for various thread
1.201 + syncronization functions.
1.202 +
1.203 +pipeping.c
1.204 + Tests inter-process pipes. Run with pipepong.c
1.205 +
1.206 +pipepong.c
1.207 + Tests inter-process pipes. Run with pipeping.c
1.208 +
1.209 +pipeself.c
1.210 + Tests inter-thread pipes.
1.211 +
1.212 +pollable.c
1.213 + Tests pollable events. prio.h
1.214 +
1.215 +poll_er.c
1.216 + Tests PR_Poll() where an error is expected.
1.217 +
1.218 +poll_nm.c
1.219 + Tests PR_Poll() where normal operation is expected.
1.220 +
1.221 +poll_to.c
1.222 + Tests PR_Poll() where timeout is expected.
1.223 +
1.224 +prftest.c
1.225 + Tests printf-like formatting.
1.226 +
1.227 +prftest1.c
1.228 + Obsolete. Subsumed in prftest.c
1.229 +
1.230 +prftest2.c
1.231 + Obsolete. Subsumed in prftest.c
1.232 +
1.233 +priotest.c
1.234 + Limited use. Tests NSPR thread dispatching priority.
1.235 +
1.236 +provider.c
1.237 +
1.238 +prpoll.c
1.239 + Tests PR_Poll().
1.240 +
1.241 +prselect.c
1.242 + Obsolete. PR_Select() is obsolete.
1.243 +
1.244 +prttools.h
1.245 + Unused file.
1.246 +
1.247 +ranfile.c
1.248 + Tests random file access.
1.249 +
1.250 +readme
1.251 + This file.
1.252 +
1.253 +runtests.ksh
1.254 + A korn shell script that runs a set of tests that should run
1.255 + on any of the NSPR supported platforms.
1.256 +
1.257 +runtests.pl
1.258 + A perl script to run the test cases. This srcipt runs tests
1.259 + common to all platforms and runs tests applicable to specific
1.260 + platforms. Uses file runtests.txt to control execution.
1.261 +
1.262 +runtests.txt
1.263 + Control file for perl script: runtests.pl
1.264 +
1.265 +rwlocktest.c
1.266 + Tests Reader/Writer lock
1.267 +
1.268 +selct_er.c
1.269 + Obsolete. PR_Select() is obsolete.
1.270 +
1.271 +selct_nm.c
1.272 + Obsolete. PR_Select() is obsolete.
1.273 +
1.274 +selct_to.c
1.275 + Obsolete. PR_Select() is obsolete.
1.276 +
1.277 +select2.c
1.278 + Obsolete. PR_Select() is obsolete.
1.279 +
1.280 +sel_spd.c
1.281 + Obsolete. PR_Select() is obsolete.
1.282 +
1.283 +sem.c
1.284 + Obsolete. Semaphores are not supported.
1.285 +
1.286 +server_test.c
1.287 + Tests sockets by simulating a server in loopback mode.
1.288 + Makes its own client threads.
1.289 +
1.290 +servr_kk.c
1.291 + Tests client/server sockets, threads using system threads.
1.292 +
1.293 +servr_ku.c
1.294 + Tests client/server sockets, threads using system and user threads.
1.295 +
1.296 +servr_uk.c
1.297 + Tests client/server sockets, threads using system and user threads.
1.298 +
1.299 +servr_uu.c
1.300 + Tests client/server sockets, threads user threads.
1.301 +
1.302 +short_thread.c
1.303 + Tests short-running threads. Useful for testing for race conditions.
1.304 +
1.305 +sigpipe.c
1.306 + Tests NSPR's SIGPIPE handler. Unix only.
1.307 +
1.308 +sleep.c
1.309 + Limited use. Tests sleep capability of platform.
1.310 +
1.311 +socket.c
1.312 + Tests many socket functions.
1.313 +
1.314 +sockopt.c
1.315 + Tests setting and getting socket options.
1.316 +
1.317 +sprintf.c
1.318 + Tests sprintf.
1.319 +
1.320 +sproc_ch.c
1.321 + Obsolete. Tests IRIX sproc-based threads.
1.322 +
1.323 +sproc_p.c
1.324 + Obsolete. Tests IRIX sproc-based threads.
1.325 +
1.326 +stack.c
1.327 + Test atomic stack operations.
1.328 +
1.329 +stat.c
1.330 + Tests performance of getfileinfo() vs. stat()
1.331 +
1.332 +stdio.c
1.333 + Tests NSPR's handling of stdin, stdout, stderr.
1.334 +
1.335 +strod.c
1.336 + Tests formatting of double precision floating point.
1.337 +
1.338 +suspend.c
1.339 + Private interfaces PR_SuspendAll(), PR_ResumeAll(), etc.
1.340 +
1.341 +switch.c
1.342 + Tests thread switching
1.343 +
1.344 +system.c
1.345 + Tests PR_GetSystemInfo()
1.346 +
1.347 +testbit.c
1.348 + Tests bit arrays.
1.349 +
1.350 +testfile.c
1.351 + Tests many file I/O functions.
1.352 +
1.353 +threads.c
1.354 + Tests thread caching.
1.355 +
1.356 +thruput.c
1.357 + Tests socket thruput. Must be run by hand as client/server.
1.358 + Does not self terminate.
1.359 +
1.360 +time.c
1.361 + Incomplete. Limited use.
1.362 +
1.363 +timemac.c
1.364 + Test time and date functions. Originally for Mac.
1.365 +
1.366 +timetest.c
1.367 + Tests time conversion over a wide range of dates.
1.368 +
1.369 +tmoacc.c
1.370 + Server to tmocon.c and writev.c
1.371 + Do not run it by itself.
1.372 +
1.373 +tmocon.c
1.374 + Client thread to tmoacc.c
1.375 +
1.376 +tpd.c
1.377 + Tests thread private data.
1.378 +
1.379 +udpsrv.c
1.380 + Tests UDP socket functions.
1.381 +
1.382 +ut_ttools.h
1.383 + unused file.
1.384 +
1.385 +version.c
1.386 + Extract and print library version data.
1.387 +
1.388 +vercheck.c
1.389 + Test PR_VersionCheck().
1.390 +
1.391 +writev.c
1.392 + Tests gather-write on a socket. Requires tmoacc.c
1.393 +
1.394 +xnotify.c
1.395 + Tests cached monitors.
1.396 +
1.397 +yield.c
1.398 + Limited use
1.399 +
1.400 +y2k.c
1.401 + Test to verify NSPR's date functions as Y2K compliant.
1.402 +
1.403 +dll\Makefile
1.404 + makefile for mygetval.c, mysetval.c
1.405 +
1.406 +dll\mygetval.c
1.407 + Dynamic library test. See also dlltest.c
1.408 +
1.409 +dll\mysetval.c
1.410 + Dynamic library test. See also dlltest.c
