This chapter describes the functions for retrieving and setting errors and the error codes set by NSPR.

For information on naming conventions for NSPR types, functions, and macros, see NSPR Naming Conventions.

Error Type

Error Functions

Error Codes

Error codes defined in prerror.h:

PR_OUT_OF_MEMORY_ERROR
Insufficient memory to perform request.
PR_BAD_DESCRIPTOR_ERROR
The file descriptor used as an argument in the preceding function is invalid.
PR_WOULD_BLOCK_ERROR
The operation would have blocked, which conflicts with the semantics that have been established.
PR_ACCESS_FAULT_ERROR
One of the arguments of the preceding function specified an invalid memory address.
PR_INVALID_METHOD_ERROR
The preceding function is invalid for the type of file descriptor used.
PR_ILLEGAL_ACCESS_ERROR
One of the arguments of the preceding function specified an invalid memory address.
PR_UNKNOWN_ERROR
Some unknown error has occurred.
PR_PENDING_INTERRUPT_ERROR
The operation terminated because another thread has interrupted it with PR_Interrupt.
PR_NOT_IMPLEMENTED_ERROR
The preceding function has not been implemented.
PR_IO_ERROR
The preceding I/O function encountered some sort of an error, perhaps an invalid device.
PR_IO_TIMEOUT_ERROR
The I/O operation has not completed in the time specified for the preceding function.
PR_IO_PENDING_ERROR
An I/O operation has been attempted on a file descriptor that is currently busy with another operation.
PR_DIRECTORY_OPEN_ERROR
The directory could not be opened.
PR_INVALID_ARGUMENT_ERROR
One or more of the arguments to the function is invalid.
PR_ADDRESS_NOT_AVAILABLE_ERROR
The network address (PRNetAddr) is not available (probably in use).
PR_ADDRESS_NOT_SUPPORTED_ERROR
The type of network address specified is not supported.
PR_IS_CONNECTED_ERROR
An attempt to connect on an already connected network file descriptor.
PR_BAD_ADDRESS_ERROR
The network address specified is invalid (as reported by the network).
PR_ADDRESS_IN_USE_ERROR
Network address specified (PRNetAddr) is in use.
PR_CONNECT_REFUSED_ERROR
The peer has refused to allow the connection to be established.
PR_NETWORK_UNREACHABLE_ERROR
The network address specifies a host that is unreachable (perhaps temporary).
PR_CONNECT_TIMEOUT_ERROR
The connection attempt did not complete in a reasonable period of time.
PR_NOT_CONNECTED_ERROR
The preceding function attempted to use connected semantics on a network file descriptor that was not connected.
PR_LOAD_LIBRARY_ERROR
Failure to load a dynamic library.
PR_UNLOAD_LIBRARY_ERROR
Failure to unload a dynamic library.
PR_FIND_SYMBOL_ERROR
Symbol could not be found in the specified library.
PR_INSUFFICIENT_RESOURCES_ERROR
There are insufficient system resources to process the request.
PR_DIRECTORY_LOOKUP_ERROR
A directory lookup on a network address has failed.
PR_TPD_RANGE_ERROR
Attempt to access a thread-private data index that is out of range of any index that has been allocated to the process.
PR_PROC_DESC_TABLE_FULL_ERROR
The process' table for holding open file descriptors is full.
PR_SYS_DESC_TABLE_FULL_ERROR
The system's table for holding open file descriptors has been exceeded.
PR_NOT_SOCKET_ERROR
An attempt to use a non-network file descriptor on a network-only operation.
PR_NOT_TCP_SOCKET_ERROR
Attempt to perform a TCP specific function on a non-TCP file descriptor.
PR_SOCKET_ADDRESS_IS_BOUND_ERRO
Attempt to bind an address to a TCP file descriptor that is already bound.
PR_NO_ACCESS_RIGHTS_ERROR
Calling thread does not have privilege to perform the operation requested.
PR_OPERATION_NOT_SUPPORTED_ERRO
The requested operation is not supported by the platform.
PR_PROTOCOL_NOT_SUPPORTED_ERROR
The host operating system does not support the protocol requested.
PR_REMOTE_FILE_ERROR
Access to the remote file has been severed.
PR_BUFFER_OVERFLOW_ERROR
The value retrieved is too large to be stored in the buffer provided.
PR_CONNECT_RESET_ERROR
The (TCP) connection has been reset by the peer.
PR_RANGE_ERROR
Unused.
PR_DEADLOCK_ERROR
Performing the requested operation would have caused a deadlock. The deadlock was avoided.
PR_FILE_IS_LOCKED_ERROR
An attempt to acquire a lock on a file has failed because the file is already locked.
PR_FILE_TOO_BIG_ERROR
Completing the write or seek operation would have resulted in a file larger than the system could handle.
PR_NO_DEVICE_SPACE_ERROR
The device for storing the file is full.
PR_PIPE_ERROR
Unused.
PR_NO_SEEK_DEVICE_ERROR
Unused.
PR_IS_DIRECTORY_ERROR
Attempt to perform a normal file operation on a directory.
PR_LOOP_ERROR
Symbolic link loop.
PR_NAME_TOO_LONG_ERROR
Filename is longer than allowed by the host operating system.
PR_FILE_NOT_FOUND_ERROR
The requested file was not found.
PR_NOT_DIRECTORY_ERROR
Attempt to perform directory specific operations on a normal file.
PR_READ_ONLY_FILESYSTEM_ERROR
Attempt to write to a read-only file system.
PR_DIRECTORY_NOT_EMPTY_ERROR
Attempt to delete a directory that is not empty.
PR_FILESYSTEM_MOUNTED_ERROR
Attempt to delete or rename a file object while the file system is busy.
PR_NOT_SAME_DEVICE_ERROR
Request to rename a file to a file system on another device.
PR_DIRECTORY_CORRUPTED_ERROR
The directory object in the file system is corrupted.
PR_FILE_EXISTS_ERROR
Attempt to create or rename a file when the new name is already being used.
PR_MAX_DIRECTORY_ENTRIES_ERROR
Attempt to add new filename to directory would exceed the limit allowed.
PR_INVALID_DEVICE_STATE_ERROR
The device was in an invalid state to complete the desired operation.
PR_DEVICE_IS_LOCKED_ERROR
The device needed to perform the desired request is locked.
PR_NO_MORE_FILES_ERROR
There are no more entries in the directory.
PR_END_OF_FILE_ERROR
Unexpectedly encountered end of file (Mac OS only).
PR_FILE_SEEK_ERROR
An unexpected seek error (Mac OS only).
PR_FILE_IS_BUSY_ERROR
The file is busy and the operation cannot be performed.
PR_IN_PROGRESS_ERROR
The operation is still in progress (probably a nonblocking connect).
PR_ALREADY_INITIATED_ERROR
The (retried) operation has already been initiated (probably a nonblocking connect).
PR_GROUP_EMPTY_ERROR
The wait group is empty.
PR_INVALID_STATE_ERROR
The attempted operation is on an object that was in an improper state to perform the request.
PR_MAX_ERROR
Placeholder for the end of the list.