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.