tor-browser

The Tor Browser
git clone https://git.dasho.dev/tor-browser.git
Log | Files | Refs | README | LICENSE

README.TXT (7263B)

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