This file is indexed.

/usr/share/doc/libgammu-dev/c/statemachine.rst is in libgammu-dev 1.33.0-3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
State machine
=============

.. c:function:: GSM_Error GSM_InitConnection_Log(GSM_StateMachine * s, int ReplyNum, GSM_Log_Function log_function, void *user_data)

    :param s: State machine data
    :param ReplyNum: Number of replies to await (usually 3).
    :param log_function: Logging function, see :c:type:`GSM_SetDebugFunction`.
    :param user_data: User data for logging function, see :c:type:`GSM_SetDebugFunction`.
    :return: Error code

    Initiates connection with custom logging callback.

.. c:function:: GSM_Error GSM_InitConnection(GSM_StateMachine * s, int ReplyNum)

    :param s: State machine data
    :param ReplyNum: Number of replies to await (usually 1). Higher value makes sense only on unreliable links.
    :return: Error code

    Initiates connection.


.. c:function:: GSM_Error GSM_TerminateConnection(GSM_StateMachine * s)

    :param s: State machine data
    :return: Error code

    Terminates connection.

.. c:function:: GSM_Error GSM_AbortOperation(GSM_StateMachine * s)

    :param s: State machine data
    :return: Error code

    Aborts current operation.
 
    This is thread safe call to abort any existing operations with the
    phone.

.. c:function: GSM_Error GSM_Install(GSM_StateMachine *s, const char *ExtraPath)

    :param s: State machine data.
    :param ExtraPath: Extra path where to search for installation data.
    :return: Result of operation.

    Installs applet required for configured connection to the phone.

.. c:type:: GSM_StateMachine

    Private structure holding information about phone connection. Should
    be allocated by :c:func:`GSM_AllocStateMachine` and freed by
    :c:func:`GSM_FreeStateMachine`.

.. c:type:: GSM_ConnectionType

     Connection types definitions.

.. c:type:: GSM_Config

    Configuration of state machine.

    .. c:member:: char Model[50]

        Model from config file.

.. c:type:: GSM_Log_Function

    :param text: Text to be printed, \n will be also sent (as a separate message).
    :param data: Arbitrary logger data, as passed to :c:func:`GSM_InitConnection_Log`.
    :returns: void

    Type of callback function for logging.

.. doxygenfunction:: GSM_ReadDevice
.. doxygenfunction:: GSM_IsConnected
.. doxygenfunction:: GSM_FindGammuRC
.. doxygenfunction:: GSM_ReadConfig
.. doxygenfunction:: GSM_GetConfig
.. doxygenfunction:: GSM_GetConfigNum
.. doxygenfunction:: GSM_SetConfigNum
.. doxygenfunction:: GSM_AllocStateMachine
.. doxygenfunction:: GSM_FreeStateMachine
.. doxygenfunction:: GSM_GetUsedConnection
.. doxygenstruct:: GSM_Config