PR_GetRandomNoise

NSPR
About NSPR
NSPR API Reference
NSPR Build Instruction
NSPR Release Process
Introduction to NSPR
NSPR Types
Threads
1. Threading Types and Constants
2. Threading Functions
Process Initialization
Locks
1. Lock Type
2. Lock Functions
Condition Variables
1. Condition Variable Type
2. Condition Variable Functions
Monitors
1. Monitor Type
2. Monitor Functions
Cached Monitors
1. Cached Monitor Functions
I/O Types
I/O Functions
Network Addresses
1. Network Address Types and Constants
2. Network Address Functions
Atomic Operations
Interval Timing
1. Interval Time Type and Constants
2. Interval Functions
Date and Time
Memory Management Operations
1. Memory Allocation Functions
2. Memory Allocation Macros
String Operations
Floating Point Number to String Conversion
Linked Lists
1. Linked List Types
  1. PRCList
2. Linked List Macros
Dynamic Library Linking
Process Management and Interprocess Communication
1. Process Management Types and Constants
  1. PRProcess
  2. PRProcessAttr
2. Process Management Functions
  1. Setting the Attributes of a New Process
  2. Creating and Managing Processes
Logging
Named Shared Memory
1. Shared Memory Protocol
2. Named Shared Memory Functions
Anonymous Shared Memory
1. Anonymous Memory Protocol
2. Anonymous Shared Memory Functions
IPC Semaphores
1. IPC Semaphore Functions
Thread Pools
1. Thread Pool Types
2. Thread Pool Functions
Random Number Generator
1. Random Number Generator Function
Hash Tables
1. Hash Tables and Type Constants
2. Hash Table Functions
NSPR Error Handling
Contribute
2. The MDN Project

Produces a random value for use as a seed value for another random number generator.

Syntax

Parameters

Returns

PRSize value equal to the size of the random number actually generated, or zero. The generated size may be less than the size requested. A return value of zero means that PR_GetRandomNoise is not implemented on this platform, or there is no available noise to be returned at the time of the call.

Description

PR_GetRandomNoise provides a random value, depending on platform. The length of the random value is dependent on the platform and its ability to provide a random value at that moment.

PR_GetRandomNoise is intended to provide a "seed" value for a another random number generator that may be suitable for cryptographic operations. This implies that the random value provided may not be, by itself, cryptographically secure. The value generated by PR_GetRandomNoise is at best, extremely difficult to predict and is as nondeterministic as the underlying platfrom permits.