summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/pr_getdesctype.rst
blob: 66cbf5839794754786c0252184dfc4f9e0add087 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
PR_GetDescType
==============

Describes what type of file is referenced by a specified file
descriptor.


Syntax
------

.. code::

   #include <prio.h>

   PRDescType PR_GetDescType(PRFileDesc *file);


Parameter
~~~~~~~~~

The function has the following parameter:

``file``
   A pointer to a :ref:`PRFileDesc` object whose descriptor type is to be
   returned.


Returns
~~~~~~~

The function returns a ``PRDescType`` enumeration constant that
describes the type of file.


Description
-----------

The ``PRDescType`` enumeration is defined as follows:

.. code::

   typedef enum PRDescType {
     PR_DESC_FILE       = 1,
     PR_DESC_SOCKET_TCP = 2,
     PR_DESC_SOCKET_UDP = 3,
     PR_DESC_LAYERED    = 4
   } PRDescType;

The enumeration has the following enumerators:

``PR_DESC_FILE``
   The :ref:`PRFileDesc` object represents a normal file.
``PR_DESC_SOCKET_TCP``
   The :ref:`PRFileDesc` object represents a TCP socket.
``PR_DESC_SOCKET_UDP``
   The :ref:`PRFileDesc` object represents a UDP socket.
``PR_DESC_LAYERED``
   The :ref:`PRFileDesc` object is a layered file descriptor.