Procedures

Changes foreground to given colour.

Resets colours.

Returns .true. if given API status types are equal.

Reads API status type from given string. Only keys found in the string are overwritten in the derived type. No error is returned if the string does not contain any of the keys. The function returns E_EMPTY if the passed string is empty.

Returns string representation of given API status type. The string contains new-line characters.

Returns argument value.

Returns .true. if argument of given name is passed without value.

Prints command-line arguments to standard output if --help or -h is passed.

Parses command-line for given arguments. Error messages are printed to standard error by default, unless verbose is .false..

Reads all arguments from command-line and prints error message if one is missing. Returns the error code of the first invalid argument.

Returns .true. if passed type is a valid argument type.

Validates given argument. Arguments of type ARG_TYPE_LEVEL are additionally converted to integer if the passed argument value is a valid log level name. For example, the argument value warning is converted to integer 3, to match log level LL_WARNING.

Returns whether array contains an integer value.

Escapes given character string by replacing ASCII control characters by an escape string. For instance, character ASCII_LF (new line) is turned into literal \n. Non-printable characters without common literal are replaced with \x plus ASCII character code in hexadecimal, from \x00 to \x1F.

Returns whether character is alpha letter.

Returns whether character is alpha-numeric.

Returns whether character is space or tabular.

Returns whether character is control character.

Returns whether character is digit.

Returns whether character is hex digit.

Returns whether character is lower-case.

Returns whether character is an octal digit.

Returns whether character is printable.

Returns whether character is upper-case.

Returns whether character is white space (either SPACE, TAB, LF, VT, FF, or CR).

Returns unescaped string of given string with escaped ASCII characters.

Converts string to 8-byte real.

Converts string to 4-byte integer.

Returns log messages in Atom Syndication Format (RFC 4287).

Encodes given input string in base64.

Returns .true. if given beats are equal.

Returns .true. if given beat type elements are valid.

Prints beat to standard output or given file unit.

Generic derived type to block converter.

Generic derived type to block writer.

Returns either argument true or false as allocatable character, depending on the value of logical value l. The result is trimmed.

Converts logical (boolean) to 4-byte integer.

Converts C logical value to Fortran representation.

Captures a single frame from a V4L device or RTSP stream with FFmpeg, and optionally adds a timestamp with GraphicsMagick. If the input is an RTSP stream, the URL must start with rtsp://.

Returns device enumerator from name. On error, the result is CAMERA_DEVICE_NONE.

Returns .true. if device enumerator is valid. The device CAMERA_DEVICE_NONE is invalid.

Returns .true. if CGI environment variable AUTH is set to Basic.

Reads HTTP request body (POST method). We have to rely on read(2) as Fortran cannot read unformatted content from standard input. On error, the string content is allocated but empty.

Unwinds percent-encoding in given input string.

Reads CGI environment variables and writes values into env.

Returns HTTP form data from standard input (application/x-www-form-urlencoded).

Generic interface to CGI get functions.

Returns whether key exists in param.

Returns whether key exists in param and has value.

Writes HTTP header. A sane HTTP server converts the status code passed in the header to a real HTTP status code, as we cannot return it in any other way with CGI. Default HTTP status is 200.

Returns key at index loc in keys array of param.

Prints content to standard output, returning it to the web server.

Decodes and parses given character string containing new-line separated key-values pairs, and returns CGI parameters in param.

Returns CGI GET parameters from environment variable QUERY_STRING as key–value pairs in param.

Adds route to router.

Creates a new router with given maximum number of routes in the routes hash table.

Finalises router.

Searches the router hash table for path in CGI environment variable PATH_INFO, and calls the associated subroutine of the route. If no route has been found, HTTP_NOT_FOUND is returned in http_status.

Returns route of associated path from internal hash table. The passed path string has to be trimmed.

Creates a new router and adds routes to endpoints.

Returns the current number of elements in the given (opaque) CGI parameter type.

Returns value at index loc in values array of param.

Closes configuration file.

Loads field value on to Lua stack.

Generic interface to return configuration value by name.

Opens configuration file and optionally loads the table of the given name if the argument has been passed.

Removes last stack element.

Returns size of configuration table.

MD4 cryptographic hash function with a 128 bit output.

MD5 cryptographic hash function with a 128 bit output.

RIPEMD-160 cryptographic hash function with a 160 bit output.

SHA-1 cryptographic hash function with a 160 bit output.

SHA-2 cryptographic hash function with a 224 bit output.

SHA-2 cryptographic hash function with a 256 bit output.

SHA-2 cryptographic hash function with a 384 bit output.

SHA-2 cryptographic hash function with a 512 bit output.

Generic derived type to CSV serialisation function.

Returns header string of CSV representation of the beat type as allocatable string.

Returns header string of CSV representation of the data point type as allocatable string.

Returns header string of CSV representation of the log type as allocatable string.

Returns header string of CSV representation of the node type as allocatable string.

Returns CSV header string of CSV representation of the observation type as allocatable string.

Returns CSV header string of CSV representation of the observation view type as allocatable string.

Returns header string of CSV representation of the sensor type as allocatable string.

Returns header string of CSV representation of the target type as allocatable string.

Generic derived type from CSV reader.

Generic derived type to CSV writer.

Attaches the database at path to the current connection. If no name is passed for the attached database, the name will be set to attached. The function trims the given path and name strings.

Creates online backup of given database. The functions assumes 500 steps and a sleep time of 250 msec by default, if the arguments are not passed.

Starts a transaction. Public alias for db_begin().

Closes connection to SQLite database. Optimises the database if optimize is .true.. Returns E_DB on error.

Ends transaction and commits changes to database. On error, does a rollback automatically. Returns E_DB_ROLLBACK if the rollback failed.

Returns number of rows in table beats.

Returns number of rows in table logs.

Returns number of rows in table nodes.

Returns number of rows in table observs.

Returns number of rows in table receivers.

Returns number of rows in table requests.

Returns number of rows in table responses.

Returns number of rows in table sensors.

Returns number of rows in table sync_logs.

Returns number of rows in table sync_nodes.

Returns number of rows in table sync_observs.

Returns number of rows in table sync_sensors.

Returns number of rows in table sync_sensors.

Returns number of rows in table sensors.

Creates logs table in given database.

Creates logs table in given database.

Initialises a connected SQLite 3 database by creating all necessary tables if they do not exist already. The function also creates additional indices and triggers on the tables.

Deletes heartbeat from database.

Deletes log from database.

Deletes node from database.

Deletes observation from database. The function expects the SQLite trigger delete_observ_trigger as defined in module dm_sql to be present in the database, in order to delete receivers, requests, and responses automatically.

Deletes sensor of given id from database.

Deletes target from database.

Detaches database from the current connection. If no name is passed for the attached database, the name is assumed to be attached. The function trims the given name string. Returns E_DB_DETACH on error.

Returns last database error as DMPACK error code, optionally the SQLite error code in argument sqlite_error. This function matches an SQLite error code to the corresponding DMPACK error code. For example, if the last SQLite error is SQLITE_OK, the function returns E_NONE.

Returns last SQLite error message.

Finalises given database statement. Returns E_DB_FINALIZE on error.

Returns application id of database in id.

Returns data version in version.

Returns status of foreign keys contraint in enabled.

Returns journal mode of database in mode. The name of the mode is optionally passed in name.

Returns status of query-only pragma in enabled.

Returns user version of database in version.

Returns .true. if log id exists.

Returns .true. if node id exists.

Returns .true. if observation id exists.

Returns .true. if sensor id exists.

Returns .true. if given table exists in database.

Returns .true. if target id exists.

Initialises SQLite backend. Returns E_DB on error.

Generic database insert function.

Adds the given heartbeat to database. The beat data is validated by default.

Adds array of beats to database. A transaction is used unless transaction is .false.. The beat data is validated by default.

Adds the given log to database. The log data is validated by default.

Adds the given node to database. The node data is validated by default.

Adds single observation to database, including receivers, requests, and responses. If the insert query fails, the transaction will be rolled back, i.e., no part of the observation is written to the database on error. The observation data is validated by default.

Adds array of observations to database. A transaction is used unless transaction is .false.. The observation data is validated by default.

Adds given sensor to database. The sensor data is validated by default.

Wrapper function that inserts or replaces given sync data into database. Sync data must have a valid type.

Inserts or replaces given log sync data into database.

Inserts or replaces given node sync data into database.

Inserts or replaces given observation sync data into database.

Inserts or replaces given sensor sync data into database.

Inserts or replaces given target sync data into database.

Adds given target to database. The target data is validated by default.

Returns .true. if database type has associated pointer.

Returns .true. if database is in read-only mode. This function checks only the opaque database type for the read-only flag. It is still possible to enable ready-only access by calling dm_db_set_query_only(). The function dm_db_get_query_only() returns the status of the query_only pragma.

Returns true if SQLite 3 was compiled threadsafe.

Sends log message to SQLite error log handler. The callback has to be set through dm_db_set_log_callback() initially.

Opens connection to the SQLite database at path, or creates a new database with given file path if create is passed and .true.. The foreign key constraint is enabled unless foreign_keys is .false..

Attempts to optimise the database. All schemas are optimised.

Returns .true. if given statement has been prepared.

Rolls a transaction back. Returns E_DB_ROLLBACK on error.

Generic database select function.

Returns heartbeat associated with given node id in beat.

Generic beats select function.

Generic data points select function.

Returns heartbeat associated with given node id as allocatable character json in JSON format.

Generic JSON logs select function.

Returns log associated with given id as allocatable character in JSON format in json. If no log has been found, the string will be empty and the function returns E_DB_NO_ROWS.

Generic JSON logs select function.

Returns nodes associated with given node id as allocatable character json in JSON format.

Generic JSON nodes select function.

Returns log associated with given id in log.

Generic logs select function.

Returns logs by observation id in allocatable array logs.

Returns node data associated with given id in node.

Generic nodes select function.

Returns observation referenced by the given id from database.

Returns observation ids in ids, with optional node id, sensor id, target id, from, to. By default, ids are returned ordered by ascending observation timestamp, unless desc is passed and .true.. The maximum number of ids may be passed in limit.

Returns observation views of the given time range from database.

Generic observations select function.

Returns observations of a given id range in observs. The argument after is the id of the observation after which the range starts, before the id of the observation that limits the range.

Returns observations of a given time span in observs.

Returns sensor data associated with given sensor id from database.

Generic sensors select function.

Returns log synchronisation data (oldest not transmitted log).

Returns log synchronisation data.

Returns node synchronisation data (oldest not transmitted node).

Returns node synchronisation data.

Returns observation synchronisation data (oldest not transmitted observation).

Returns observation synchronisation data.

Returns sensor synchronisation data (oldest not transmitted sensor).

Returns sensor synchronisation data.

Returns target synchronisation data (oldest not transmitted target).

Returns sensor synchronisation data.

Returns an array containing the names of all tables in the given database.

Returns target data associated with given target id from database.

Generic targets select function.

Set the 32-bit signed big-endian “Application ID” integer located at offset 68 into the database header.

Auto-vacuuming is only possible if the database stores some additional information that allows each database page to be traced backwards to its referrer. Therefore, auto-vacuuming must be turned on before any tables are created. It is not possible to enable or disable auto-vacuum after a table has been created.

Sets SQLite busy callback that is invoked whenever the database is busy.

Sets SQLite busy timeout in msec. Returns E_DB on error.

Sets foreign keys constraint.

Sets journal mode.

Sets SQLite error log callback. The dummy argument client_data is passed to the callback routine. The function returns E_DB on error.

Sets query-only pragma.

Sets SQLite error log callback. The dummy argument client_data is passed to the callback routine. The function returns E_DB on error.

Sets database user version.

Finalises SQLite handle. Returns E_DB on error.

Delays execution for given duration in msec.

Generic database update function.

Updates the given node in database. The node data is validated by default.

Updates given sensor in database. The sensor data is validated by default.

Updates the given target in database. The target data is validated by default.

Vacuums database schema main, or, if into is passed, vacuums it into new database at given path.

Validates an opened DMPACK database. The application id must match the constant DB_APPLICATION_ID, and the user version must be equal to DB_USER_VERSION.

Returns SQLite 3 library version as allocatable string.

Converts angle from degrees to gon.

Converts angle from degrees to radiants.

Returns data point as 58 characters long string. The attributes x and y are separated by white space.

Generic environment variable access.

Returns .true. if the environment variable of the given name exists and has a value.

Returns whether two real numbers are approximately the same.

Returns whether given error code is (likely) valid.

Returns error message of given error code error.

Prints error description to stderr. If verbose is .true., the routine outputs even if no error occured (E_NONE).

Converts Fortran logical value to C representation.

Accepts new FastCGI connection (blocking). The function returns .false. on error.

Reads HTTP request body (POST method). The the content length is 0, the argument content will be allocated but empty on output.

Writes HTTP header. A sane HTTP server converts the status code in the header to a real HTTP status code, as we cannot return it in any other way with FastCGI. The default HTTP status code is 200.

Writes given content as response. The argument will be null-terminated.

Closes named pipe.

Creates new named pipe.

Opens named pipe.

Reads from named pipe and returns number of bytes read. The read string is returned in bytes. Argument error is set to E_NULL if fifo is not connected.

Deletes file at given file path. Returns E_IO on error.

Returns .true. if file at given file path exists.

Returns number of lines in given file by counting new lines. Sets error to E_IO if opening the file failed, and to E_EMPTY if the file has no lines.

Reads file contents as byte stream into allocatable character string.

Returns file size in file storage units (usually, bytes). On error, size is 0 and the error code E_NOT_FOUND is returned in dummy argument error.

Returns status of file at given path in status. The function returns E_SYSTEM on error.

Creates empty file at given file path. Returns E_IO on error.

Writes content to given file (ASCII or binary).

Returns format enumerator from given name. If the argument is not a valid format, the function returns FORMAT_NONE.

Returns .true. if given format is valid. FORMAT_NONE is an invalid format.

Converts 8-byte real to type (for response values).

Generic real to string converter.

Prepares a DMPACK request type by setting request command, response pattern, response delimiter, and response definition array.

Request of FTR_AbortDownload procedure. Creates request to abort or end the file download command.

Request of FTR_AbortList procedure. Creates request to abort or end the file list command.

Request of BMM_BeepAlarm procedure. Creates request to output an alarm signal (triple beep).

Request of BMM_BeepNormal procedure. Creates request to output an alarm signal (single beep).

Request of IOS_BeepOff procedure. Creates request to stop an active beep signal.

Request of IOS_BeepOn procedure. Creates request for continuous beep signal of given intensity.

Request of AUT_ChangeFace procedure. Creates request for turning the telescope to the other face.

Request of FTR_Delete procedure. Creates request for deleting one or more files.

Request of TMC_DoMeasure procedure. Creates request for trying a distance measurement. This command does not return any values.

Request of FTR_Download procedure. Creates request to get a single block of data. The FTR_SetupDownload command has to be called first.

Request of AUT_FineAdjust procedure. Creates request for automatic target positioning.

Request of TMC_GetAngle5 procedure. Creates request for returning a simple angle measurement.

Request of TMC_GetAngle1 procedure. Creates request for returning a complete angle measurement.

Request of TMC_GetAngSwitch procedure. Creates request for getting the angular correction status.

Request of TMC_GetAtmCorr procedure. Creates request for getting the atmospheric correction parameters.

Request of TMC_GetAtmPpm procedure. Creates request for getting the atmospheric ppm correction factor.

Request of TMC_IfDataAzeCorrError procedure. Creates request for getting the ATR error status.

Request of BAP_GetATRSetting procedure. Creates request for getting the current ATR Low-Vis mode.

Request of COM_GetBinaryAvailable procedure. Creates request for getting the binary attribute of the server.

Request of SUP_GetConfig procedure. Creates request for getting the power management configuration status. The power timeout specifies the time after which the device switches into the mode indicated by autopwr.

Request of TMC_GetCoordinate procedure. Creates request for getting the coordinates of a measured point.

Request of CSV_GetDateTime procedure. Creates request for getting the current date and time of the instrument. A possible response may look like %R1P,0,0:0,1996,'07','19','10','13','2f'.

Request of CSV_GetDateTimeCentiSec procedure. Creates request for getting the current date and time of the instrument, including centiseconds.

Request of CSV_GetDeviceConfig procedure. Creates request for getting the instrument configuration.

Request of COM_GetDoublePrecision procedure. Creates request for getting the double precision setting – the number of digits to the right of the decimal point – when double floating-point values are transmitted.

Request of TMC_GetEdmMode procedure. Creates request for getting the EDM measurement mode.

Request of EDM_GetEglIntensity procedure. Creates request for getting the value of the intensity of the electronic guide light (EGL).

Request of TMC_GetFace procedure. Creates request for getting the face of the current telescope position.

Request of AUT_GetFineAdjustMode procedure. Creates request for getting the fine adjustment positioning mode.

Request of TMC_GetFullMeas procedure. Creates request to query angle, inclination, and distance measurement values.

Request of COM_GetSWVersion procedure. Creates request for getting the GeoCOM server software version.

Request of TMC_GeoPpm procedure. Creates request for getting the geometric ppm correction factor.

Request of TMC_GetHeight procedure. Creates request for getting the current reflector height.

Request of IMG_GetTccConfig procedure. Creates request to read the current image configuration. The response subfunc is a binary combination of the following settings:

Request of TMC_GetInclineSwitch procedure. Creates request for getting the dual-axis compensator status.

Request of TMC_IfDataIncCorrError procedure. Creates request for getting the inclination error status.

Request of CSV_GetInstrumentName procedure. Creates request for getting the Leica-specific instrument name.

Request of CSV_GetInstrumentNo procedure. Creates request for getting the factory defined instrument number.

Request of CSV_GetIntTemp procedure. Creates request for getting the internal temperature of the instrument, measured on the mainboard side.

Request of MOT_ReadLockStatus procedure. Creates request for returning the condition of the Lock-In control.

Request of BAP_GetMeasPrg procedure. Creates request for getting the distance measurement program of the instrument.

Request of CSV_CheckPower procedure. Creates request for checking the available power.

Request of TMC_GetPrismCorr procedure. Creates request for getting the prism constant.

Request of BAP_GetPrismDef procedure. Creates request for getting the default prism definition.

Request of TMC_GetPrismType procedure. Creates request for getting the default prism type.

Request of TMC_GetPrismType2 procedure. Creates request for getting the default or user prism type.

Request of TMC_QuickDist procedure. Creates request for returning the slope distance and both angles.

Request of BAP_GetRedATRFov procedure. Creates request for getting the reduced ATR field of view.

Request of CSV_GetReflectorlessClass procedure. Creates request for getting the RL type.

Request of TMC_GetRefractiveMethod procedure. Creates request for getting the refraction model.

Request of AUT_GetSearchArea procedure. Creates request for getting the dimensions of the PowerSearch window.

Request of TMC_GetSignal procedure. Creates request for getting the EDM signal intensity.

Request of TMC_GetSimpleCoord procedure. Creates request for returning cartesian coordinates.

Request of TMC_GetSimpleMea procedure. Creates request for returning the values of the angle and distance measurement.

Request of TMC_GetSlopeDistCorr procedure. Creates request for getting the total ppm and prism correction.

Request of CSV_GetSWVersion procedure. Creates request for getting the system software version of the instrument.

Request of TMC_GetStation procedure. Creates request for getting the station coordinates of the instrument.

Request of BAP_GetTargetType procedure. Creates request for getting the EDM type.

Request of AUT_ReadTimeout procedure. Creates request for getting the timeout for positioning.

Request of AUT_ReadTol procedure. Creates request for getting the positioning tolerances.

Request of AUS_GetUserAtrState procedure. Creates request for getting the status of the ATR mode.

Request of AUS_GetUserLockState procedure. Creates request for getting the status of the Lock mode.

Request of BAP_GetUserPrismDef procedure. Creates request for getting the user prism definition.

Request of AUT_GetUserSpiral procedure. Creates request for getting the user-defined search spiral.

Request of FTR_List procedure. Creates request for listing file information.

Request of AUT_LockIn procedure. Creates request for starting the target tracking.

Request of BAP_MeasDistanceAngle procedure. Creates request for measuring Hz, V angles and a single distance.

Request of COM_NullProc procedure. Creates request for checking the communication.

Request of AUT_PS_EnableRange procedure. Creates request for enabling the PowerSearch window and range.

Request of AUT_PS_SearchNext procedure. Creates request for searching for the next target.

Request of AUT_PS_SearchWindow procedure. Creates request for starting PowerSearch.

Request of AUT_PS_SetRange procedure. Creates request for setting the PowerSearch range.

Request of AUT_Search procedure. Creates request for performing an automatic target search.

Request of BAP_SearchTarget procedure. Creates request for searching a target.

Request of TMC_SetAngSwitch procedure. Creates request for turning angle corrections on or off.

Request of BAP_SetAtmCorr procedure. Creates request for setting the atmospheric correction parameters.

Request of BAP_SetAtmPpm procedure. Creates request for setting the atmospheric ppm correction factor.

Request of BAP_SetATRSetting procedure. Creates request for setting the ATR low-vis mode.

Request of COM_SetBinaryAvailable procedure. Creates request for setting the binary attribute of the server.

Request of SUP_SetConfig procedure. Creates request for setting the power management configuration.

Request of CSV_SetDateTime procedure. Creates request for setting the date and time of the instrument.

Request of TMC_SetHandDist procedure. Creates request for setting the slope distance and height offset.

Request of COM_SetDoublePrecision procedure. Creates request for setting the double precision.

Request of TMC_SetEdmMode procedure. Creates request for setting the EDM measurement mode.

Request of EDM_SetEglIntensity procedure. Creates request for setting the intensity of the electronic guide light.

Request of AUT_SetFineAdjustMode procedure. Creates request for setting the fine adjust positioning mode.

Request of TMC_SetGeoPpm procedure. Creates request for setting the geometric ppm correction factor.

Request of TMC_SetHeight procedure. Creates request for setting a new reflector height.

Request of IMG_SetTccConfig procedure. Creates request for setting the image configuration.

Request of TMC_SetInclineSwitch procedure. Creates request for turning the dual-axis compensator on or off.

Request of EDM_Laserpointer procedure. Creates request for turning the laser pointer on or off.

Request of BAP_SetMeasPrg procedure. Creates request for setting the distance measurement program.

Request of TMC_SetOrientation procedure. Creates request for orientating the instrument in horizontal direction.

Request of AUT_MakePositioning procedure. Creates request for turning the telescope to a specified position.

Request of AUT_SetTimeout procedure. Creates request for setting the timeout for positioning.

Request of TMC_SetPrismCorr procedure. Creates request for setting the prism constant. The API function BAP_SetPrismType overwrites this setting.

Request of BAP_SetPrismType procedure. Creates request for setting the default prism type.

Request of BAP_SetPrismType2 procedure. Creates request for setting the default or user prism type.

Request of BAP_SetRedATRFov procedure. Creates request for setting the reduced ATR field of view.

Request of TMC_SetRefractiveMethod procedure. Creates request for setting the refraction model.

Request of AUT_SetSearchArea procedure. Creates request for setting the PowerSearch window.

Request of TMC_SetStation procedure. Creates request for setting the station coordinates of the instrument.

Request of BAP_SetTargetType procedure. Creates request for setting the EDM type.

Request of AUT_SetTol procedure. Creates request for setting the positioning tolerances.

Request of AUS_SetUserAtrState procedure. Creates request for setting the status of the ATR state.

Request of AUS_SetUserLockState procedure. Creates request for setting the status of the Lock state.

Request of BAP_SetUserPrismDef procedure. Creates request for setting a user prism definition.

Request of AUT_SetUserSpiral procedure. Creates request for setting the ATR search window.

Request of MOT_SetVelocity procedure. Creates request for driving the instrument with constant speed.

Request of FTR_SetupDownload procedure. Creates request for setting up a file download.

Request of FTR_SetupList procedure. Creates request for setting up file listing.

Request of MOT_StartController procedure. Creates request for starting the motor controller.

Request of MOT_StartController procedure. Creates request for stopping the motor controller.

Request of COM_SwitchOffTPS procedure. Creates request for turning the instrument off.

Request of COM_SwitchOnTPS procedure. Creates request for turning the instrument on.

Request of IMG_TakeTccImage procedure. Creates request for capturing a telescope image.

Returns message associated with given GeoCOM (error) code.

Returns .true. if given GeoCOM code is an error.

Returns .true. if given GeoCOM code is not an error.

Parameterisation function for GeoCOM enumeration types.

Returns GeoJSON feature point of given DMPACK type, longitude, latitude, altitude, and type data in JSON. The output string geojson is of the following form:

Generic derived type to GeoJSON serialisation functions.

Generic derived type to GeoJSON writer.

Draws text camera image file, using GraphicsMagick. By default, the text box is drawn to the bottom-left corner of the image.

Uses GraphicsMagick to determine the dimensions of the image at given path. On error, width and height are 0.

Uses GraphicsMagick to return the directory part of the image path. On error, the string directory is allocated but empty.

Uses GraphicsMagick to read the image file extension (jpg, png, ...). On error, the string file_format is allocated but empty.

Uses GraphicsMagick to determine the image file format (JPEG, PNG, ...). On error, the string file_format is allocated but empty.

Determines the MIME type of the image through file format. The following file formats are recognised: GIF, JPEG, PNG, SVG. On error, the string mime is allocated but empty.

Converts angle from gon to degrees.

Converts angle from gon to radiants.

Dan Bernstein’s DJB2 non-cryptographic hash algorithm.

Dan Bernstein’s DJB2a (XOR) non-cryptographic hash algorithm.

32-bit Fowler–Noll–Vo hash function (FNV-1). Uses a 64-bit signed integer to store the unsigned 32-bit hash.

32-bit Fowler–Noll–Vo hash function (FNV-1a). Uses a 64-bit signed integer to store the unsigned 32-bit hash.

Create a new hash table with maximum number of entries.

Finalises hash table. If the hash table items contain allocatable data types, you have to deallocate them manually beforehand.

Generic interface to hash table get functions.

Returns .true. if hash table arrays have been allocated.

Adds element to hash table, or replaces existing value. This function does not resolve hash collisions.

Returns cursor position in n and maximum size of hash table in max_size.

Generic HDF5 close function.

Destroys HDF5 Fortran interface. Returns E_HDF5 on error.

Returns amount of free space within a file in argument free_space.

Returns .true. if file at given path is a valid HDF5 file.

Returns file path of given HDF5 file in path. The argument path must be large enough to hold the full path. The actual length is returned in optional argument n.

Returns .true. if group of given name name exists in file or group id. The function returns the following error codes in error:

Returns the status of the given filter. The following filters are supported:

Initialises HDF5 Fortran interface. The function returns E_HDF5 on error.

Generic HDF5 open function.

Generic HDF5 read function.

Returns HDF5 library version as allocatable string.

Returns version numbers of HDF5 library. The function returns E_HDF5 on error.

Generic HDF5 write function.

Returns HTML anchor tag. Address and inner HTML of the anchor element are encoded by default.

Returns table of single beat in HTML format.

Returns table of heartbeats in HTML format. If argument prefix is passed, the node ids are enclosed in HTML anchors, with the link set to prefix.

Returns HTML button element. An invalid button type will be replaced with HTML_BUTTON_TYPE_BUTTON. This function does not encode the argument.

Returns HTML table of CGI environment variables.

Returns HTML comment. The given string is enclosed by <!-- and //-->. This function does not encode the argument.

Returns base64-encoded data URI of given data and MIME type.

Reverses HTML encoding.

Returns encoded input string, with some HTML special characters replaced (", &, ', <, >).

Returns HTML of (encoded) error description.

Returns HTML figure. The content should end with a newline. The caption will be HTML encoded.

Returns HTML footer. The content will not be HTML encoded.

Returns HTML header with DOCTYPE and optional CSS. Links to the style sheet files and internal CSS can be added.

Returns HTML heading of given level level and string str, with optional <small> child in small.

Returns HTML image tag. This function does not encode the arguments.

Returns HTML input element.

Returns HTML label element. This function does not encode the arguments.

Returns link element. Link address and text will be trimmed and encoded.

Returns log as HTML table. The input data will be trimmed and encoded.

Returns table of logs in HTML format. If argument prefix is passed, the log timestamps are enclosed in HTML anchors, with the link set to prefix. By default, a node id column is added to the table. Optionally, a maximum log message length can be set. The input data will be trimmed and encoded.

Returns <mark> element of optional class, with encoded str enclosed. This function encodes the passed string.

Returns HTML navigation element with unordered list of links. If optional array mask is passed, anchors are added according to their mask state.

Returns sensor node as HTML table. Input data will be trimmed and encoded.

Returns sensor nodes as HTML table. Input data will be trimmed and encoded.

Returns observation as HTML table. Input data will be trimmed and encoded.

Returns table of observs in HTML format. If argument prefix is passed, the observation names are enclosed in HTML anchors, with the link set to prefix. The table always contains index and timestamp. The columns id, node id, sensor id, target id, name, and error are optional. Input data will be trimmed and encoded.

Returns HTML paragraph. This function does not encode the argument str unless encode is .true..

Returns HTML preformatted text, with optional <code> tag. This function does not encode the argument str.

Returns request as HTML table. Input data will be trimmed and encoded.

Returns responses as HTML table. Input data will be trimmed and encoded.

Returns <script> element with URL source to JavaScript file. The source will be encoded.

Returns HTML select element with option values. This function does not encode or trim the arguments.

Allocates memory for arrays in select type. Returns E_ALLOC on error.

Deallocates arrays in select type.

Sets option name and value in select type.

Returns sensor as HTML table. Input data will be trimmed and encoded.

Returns table of sensors in HTML format. If argument prefix is passed, the sensor names are enclosed in HTML anchors, with the link set to prefix. Input data will be trimmed and encoded.

Returns <small> element with encoded str enclosed.

Returns <span> element of optional class, with encoded str enclosed.

Returns target as HTML table.

Returns table of targets in HTML format. If argument prefix is passed, the target names are enclosed in HTML anchors, with the link set to prefix. Input data will be trimmed and encoded.

Returns str enclosed by <td> tag, with optional column or row span. The passed string will not be encoded or trimmed.

Returns str enclosed by <th> tag, with optional column or row span. The passed string will not be encoded or trimmed.

Returns <time> element with datetime attribute, and the encoded ISO 8601 time stamp time enclosed. This function does not validate or encode the passed time stamp. The value of the datetime attribute is extracted from the time stamp and converted according to the HTML specification (with microseconds stripped).

Returns allocatable string of HTTP status. Returns an empty string if the passed status is unknown.

Returns .true. if given string is a valid id. A valid id must be between 1 and 32 characters long, and all characters have to be in set [-0-9A-Z_a-z]. The optional argument max_len overwrites the default maximum id length.

Connects to XMPP server.

Creates IM context. Logging to standard error is disabled by default or if log_level is IM_LL_NONE. Make sure that argument im is not created already.

Returns C pointer to new error iq stanza.

Returns C pointer to new http upload iq stanza.

Returns C pointer to new ping iq stanza.

Returns C pointer to new result iq stanza.

Destroys XMPP context and an closes the connection if still open.

Disconnects from server and releases connection.

Initialises XMPP backend (libstrophe).

Returns .true. if connection is open.

Saves current XMPP stream management state to Jabber context.

Starts XMPP event loop.

Creates and sends presence to XMPP server.

Sends stanza to server and releases it by default.

Shuts down XMPP backend (libstrophe).

Stops event loop (libstrophe).

Returns increased integer value.

Initialises DMPACK. Shall be executed once before any DMPACK routines are called to initialise the PRNG.

Converts 4-byte integer to 8-byte real.

Converts signed 4-byte integer to unsigned 2-byte integer.

Converts 8-byte integer to 8-byte real.

Converts signed 8-byte integer to unsigned 4-byte integer.

Returns .true. if given code is an error (not E_NONE).

Returns .true. if given code is not an error (E_NONE).

Generic integer to string converter.

Adds job to job list at the next free index in job array.

Returns .true. if job list contains any enabled jobs.

Returns number of (enabled) jobs in job list.

Deallocates job list.

Initialises job list. The function returns E_ALLOC on error.

Returns copy of next enabled job. If disabled is .true., the next job is returned regardless of state. One-time jobs are disabled by this function. If the job list has been finished and restarted from the beginning, revolved is set to .true..

Returns size of job list array.

Escapes passed character string by replacing each occurance of \ with \\.

Generic derived type to JSON converter.

Generic derived type to JSON writer.

Generic derived type to JSON Lines converter.

Generic derived type to JSON Lines writer.

LA_GELS computes the minimum-norm least squares solution to one or more real or complex linear systems of the form Ax = b, A^Tx = b or A^H*x = b using a QR or LQ factorization of A. Matrix A is rectangular assumed to be of full rank. The vectors b and corresponding solution vectors x are the columns of matrices denoted B and X, respectively.

LAPACK95 interface driver routine (version 3.0) -- UNI-C, Denmark; Univ. of Tennessee, USA; NAG Ltd., UK September, 2000

LA_GELSS and LA_GELSD compute the minimum-norm least squares solution to one or more real or complex linear systems A*x = b using the singular value decomposition of A. Matrix A is rectangular and may be rank-deficient. The vectors b and corresponding solution vectors x are the columns of matrices denoted B and X, respectively.

Generic LAPACK gels() subroutine for dgels() and dgels1().

Generic LAPACK gelsd() subroutine for dgelsd() and dgelsd1().

Returns .true. if given logs are equal.

Returns .true. if given log is valid. A log is valid if it conforms to the following rules:

Returns log level from string argument name. The string is converted to lower-case before. If name neither matches none, debug, warning, error, critical, nor user this function returns LL_NONE.

Return log level from string, either level name or numeric level.

Returns .true. if given log level is valid. The following level are valid:

Prints log to standard output or given file unit.

Returns pointer to global logger. The function allocates the logger if it does not exist yet.

Converts logical to 8-byte real (0.0 for .false. and 1.0 for .true.).

Alias for procedure.

Lua function deg2gon() that converts angle from [deg] to [gon].

Lua function deg2rad() that converts angle from [deg] to [rad].

Lua function gon2deg() that converts angle from [gon] to [deg].

Lua function gon2rad() that converts angle from [gon] to [rad].

Lua function rad2deg() that converts angle from [rad] to [deg].

Lua function rad2gon() that converts angle from [rad] to [gon].

This function exports parameters and procedures of the DMPACK API to the given Lua environment lua.

Calls Lua function on top of stack.

Closes Lua.

Dumps stack to standard output or file unit.

Converts Lua error code to DMPACK error code.

Returns last error message as allocatable character string or an empty string if no message is available.

Escapes passed character string by replacing each occurance of \ with \\.

Executes Lua command passed in character string command.

Executes Lua script.

Pushes table element on stack and optionally returns value.

Converts derived types to Lua table on stack.

Registers all GeoCOM API procedures and type parameters in given Lua environment lua, unless procedures is .false.. If errors is passed and .true., all named GeoCOM return code parameters are registered as well.

Pushes table index on stack and optionally returns value.

Initialises Lua interpreter and opens libraries, unless libs is .false.. Returns E_EXIST if the Lua pointer is already associated, and E_LUA if one of the Lua calls failed.

Returns .true. if element on top of stack is of type function.

Returns .true. if element on top of stack is nil.

Returns .true. if pointer to Lua interpreter is associated.

Returns .true. if element on top of stack is of type table.

Opens Lua script and executes it by default. The function returns the following error codes:

Pops element on stack.

Pushes global variable on stack and optionally returns value.

Registers a new Lua command.

Loads global table of given name. The function returns the following error codes:

Returns size of table on stack. Returns -1 on error.

Converts Lua table to Fortran derived type.

Returns 4-byte integer from Lua stack at position idx.

Returns 8-byte integer from Lua stack at position idx.

Returns 8-byte integer from Lua stack at position idx.

Returns 4-byte real from Lua stack at position idx.

Returns 8-byte real from Lua stack at position idx.

Returns allocatable character string from Lua stack at position idx.

Unescapes passed character string by replacing each occurance of \\ with \.

Returns Lua version as allocatable string of the form 5.4 or liblua/5.4 if argument name is .true..

Returns Lua version number.

Generic function that returns formatted addresses.

Generic function to create mail or server data type.

Creates new mail type and inserts passed values. The function return E_INVALID if given arguments are invalid or incomplete.

Returns SMTP server type. Argument tls may be one of the following:

Converts cURL easy stack error code to DMPACK error code.

Return message associated with given cURL error code as allocatable character string.

Initialises SMTP backend. The function returns E_MAIL on error.

Generic routine to print mail and server type.

Callback function to upload payload passed via data to the memory chunk in ptr. Do not call this function directly.

Sends SMTP request by calling libcurl.

Cleans up SMTP backend.

Returns allocatable string of SMTP server URL in the form smtp[s]://host[:port]/. Uses the URL API of libcurl to create the URL. By default, Transport Layer Security is disabled.

Returns allocatable e-mail string. This function does not verify the allocation state of the given mail type. It has been made public to simplify testing.

Returns byte order named parameter associated with given string. Sets argument byte_order to MODBUS_REAL_ACBD if string is ABCD (case insensitive). Returns E_INVALID and sets byte_order to MODBUS_REAL_ABCD if the string is invalid.

Closes the Modbus RTU/TCP connection.

Connects to Modbus RTU/TCP device.

Generic function to create Modbus RTU or TCP context.

Creates a new Modbus RTU context.

Creates a new Modbus TCP context.

Destroys the Modbus RTU/TCP context.

Returns error message from libmodbus.

Flushes non-transmitted data.

Returns real value from two registers of given byte order in argument value. The argument byte order must be one of the following:

Returns real value from two registers in ABCD byte order.

Returns real value from two registers in BADC byte order.

Returns real value from two registers in CDAB byte order.

Returns real value from two registers in DCBA byte order.

Gets the current Modbus RTU serial mode (RS-232 or RS-485).

Gets current slave number in the Modbus context.

Reads many registers from address. The size of argument registers determines the number of registers to read, unless optional argument n is passed. The function uses the Modbus function code 0x03 (read holding registers).

Sets debug flag of the Modbus context. Returns E_MODBUS on error.

Sets real value to registers of given byte order. The argument byte order must be one of the following:

Returns real value to registers in ABCD byte order.

Returns real value to registers in BADC byte order.

Sets real value to registers in CDAB byte order.

Sets real value to registers in DCBA byte order.

Sets the Modbus RTU serial mode to RS-232 or RS-485. This API function is only supported on Linux kernels 2.6.28 onwards.

Sets slave number in the Modbus context.

Returns libmodbus version as allocatable string.

Writes register to address. The function uses the Modbus function code 0x06 (preset single register).

Writes many registers to address. The size of argument registers determines the number of registers to write, unless optional argument n is passed. The function uses the Modbus function code 0x10 (preset multiple registers).

Initialises MQTT backend.

Publishes MQTT message message on topic with address url by calling libcurl.

Cleans up MQTT backend.

Returns allocatable string of URL to MQTT server. Uses the URL API of libcurl to create the URL. If port is 0, the default port will be used. The topic must start with character /.

Returns message queue attributes.

Closes message queue.

Generic function to forward derived types via message queue.

Generic message queue open function.

Generic message queue read function.

Deletes POSIX message queue.

Generic message queue write function.

Pauses program execution for given time in mseconds.

Creates a new mutex. Returns E_SYSTEM on error.

Destroys mutex. Returns E_SYSTEM on error.

Returns .true. if mutex is locked.

Locks mutex. Returns E_SYSTEM on error.

Tries to lock mutex. Returns E_SYSTEM on error.

Unlocks mutex. Returns E_SYSTEM on error.

Converts type to static or allocatable namelist string.

Reads namelist from file or standard input.

Converts namelist string to type.

Writes namelist to file or standard output.

Returns .true. if given nodes are equal.

Returns .true. if given node type elements are valid.

Prints node to standard output or given file unit.

Validates and adds receiver to observation.

Appends a request to an observation. Returns E_BOUNDS if the list of requests is full. The function does not validate the given request.

Returns .true. if given observations are equal.

Searches requests array of the observation for responses of passed name and returns the index of the first found. If no request of this name is found, E_NOT_FOUND is returned and request and index are set to 0.

Returns .true. if given observation is valid. An observation is valid if it conforms to the following requirements:

Prints observation to standard output or given file unit.

Returns .true. if given observation views are equal.

Returns a parsed path or an empty string on error. The following format descriptors are allowed:

Alias for dm_error_out(), do not use.

Returns .true. if both persons are equal.

Returns .true. if the person has a e-mail address.

Returns .true. if the person has a name.

Closes pipe to process.

Closes pipe to process (binary).

Returns .true. if pipe is connected.

Opens a process by creating a pipe, forking, and invoking the shell. Access mode has to be either PIPE_RDONLY or PIPE_WRONLY.

Creates three anonymous pipes for bidirectional IPC (stdin, stdout, stderr).

Reads from pipe to buffer bytes (binary) and returns number of bytes written to buffer.

Writes to pipe. Trims the string, adds new line and null-termination.

Writes to pipe (binary) and returns the number of bytes written.

Returns Gnuplot's standard error output in allocatable character string bytes. The result is allocated but empty if no output to standard error has been made.

Plots XY data points as line chart.

Returns number of bytes read from Gnuplot, and plot data in bytes.

Returns Gnuplot terminal backend of given name.

Returns .true. if the given terminal is valid. PLOT_TERMINAL_NONE is an invalid terminal.

Returns Gnuplot version as allocatable string. This function is quite slow as Gnuplot has to be started in a new process.

Converts angle from radiants to degrees.

Converts angle from radiants to gon.

Converts 4-byte real to 8-byte real.

Converts 8-byte real to 4-byte integer.

Converts 8-byte real to 8-byte integer.

Converts 8-byte real to logical. If f equals 0.0, the result is .false., else .true..

Converts 8-byte real to 4-byte real

Creates new regular expression type from given pattern. Returns E_REGEX_COMPILE on error.

Destroys compiled regular expression.

Returns group value in given subject from compiled regular expression.

Returns E_NONE if given subject matches the compiled regular expression.

Extracts all values by group from raw response in given request type. The regular expression is compiled and destroyed by this function. The response error is set to any occuring error code.

Returns response string from raw response, extracted by group name name. If pattern is passed, it is used as the regular expression pattern instead of the request pattern.

Returns .true. if given report type is valid, else .false..

Validates and appends response to the given request.

Returns .true. if given requests are equal.

Generic function to get value, unit, type, and error of a response.

Searches request for responses of passed name and returns the index of the first found. If no response of this name is found, the index is set to 0.

Returns .true. if given observation request is valid. A request is valid if it conforms to the following requirements:

Prints request to standard output or given file unit.

Generic function to set value, unit, type, and error of a response.

Sets error code of all responses of the given request. If argument name is given, the error is set only for the first response of the same name. The function returns E_NOT_FOUND is argument name is given and not found within the responses.

Returns .true. if given responses are equal.

Returns .true. if given response is valid. A response is valid if attribute name is a valid id, attribute type is a valid response value type, and attribute error is a valid error code.

Prints response to standard output or given file unit.

Returns .true. if the given response value type is valid.

Returns allocatable string of response value type name, or invalid if the type is invalid.

Converts cURL easy stack error code to DMPACK error code.

Return message associated with given cURL error code as allocatable character string.

Converts cURL multi stack error code to DMPACK error code.

Initialises RPC backend. The function returns E_RPC on error.

Generic RPC post function.

Sends a single derived type in Namelist format to a given URL, with optional authentication and compression. The URL has to be the API endpoint that accepts HTTP POST requests.

Sends multiple derived types concurrently in Namelist format to the given URL, with optional authentication and compression. The URL has to be the API endpoint that accepts HTTP POST requests.

Generic RPC request function.

Sends multiple HTTP requests by GET, POST, or PUT method, with optional deflate or zstd compression.

Sends single HTTP request by GET, POST, or PUT method, and with optional deflate or zstd compression.

Auxiliary destructor routine to free allocated request memory. Cleans-up the cURL handles of the request.

Cleans up RPC backend.

Returns allocatable string of URL to HTTP-RPC API endpoint. Uses the URL API of libcurl to create the URL. The base path and the endpoint must both start with a /.

Returns version number of libcurl an linked libreries as allocatable string.

C-interoperable write callback function for libcurl. Writes the received response chunks to rpc_response_type pointer that has to be passed through C pointer data. Do not call this function directly.

Returns atmospheric correction value [ppm]. Multiply by 10e-6 before applying the correction value to a slope distance [m]. If no relative humidity is passed, the default 60 % of the instrument is used instead.

Applied atmospheric correction [ppm] and prism constant [mmm] to uncorrected slope distance [m].

The magnitude of the projection distortion is in accordance with the projection system used in a particular country, for which official tables are generally available. The used formula is valid for cylindrical projections such as that of Gauss-Krüger.

Returns sea level correction value [ppm] for an EDM of the given height above sea level [m]. The value of the result is always negative. Multiply by 10e-6 before applying the correction value to a slope distance [m].

Returns horizontal distance [m] from slope distance slope_dist [m] and vertical angle v [rad]. The default mean refraction coefficient k is 0.13.

Returns (slope) distance as arithmetic mean of all measurements.

Generic interface to standard deviation functions.

Returns standard deviation of a single slope distance measurement.

Returns the standard deviation of the arithmetic mean of the distance.

Returns height difference [m] from slope distance slope_dist [m] and vertical angle v [rad]. The default mean refraction coefficient k is 0.13.

Closes named semaphore. The function returns the following error codes:

Destroys unnamed semaphore. The function returns the following error codes:

Initialises unnamed semaphore. The function returns the following error codes:

Returns the name of the semaphore.

Opens and optionally creates named semaphore. The given name shall not start with a leading /.

Post to named or unnamed sempahore.

Unlinks named semaphore. Returns E_SYSTEM on error.

Get value of named or unnamed sempahore.

Wait for named or unnamed sempahore.

Returns .true. if given sensors are equal.

Returns .true. if the attributes of the given sensor type are valid.

Prints sensor to standard output or given file unit.

Returns type enumerator from given name.

Returns .true. if type is valid sensor type. The type SENSOR_TYPE_NONE is a valid type.

Returns name of given type enumerator as allocatable string.

Returns name of signal as allocatable string. If the signal number is unknown, the numeric value is returned instead.

Registers passed C-interoperable POSIX signal callback routine for SIGINT, SIGQUIT, SIGABRT, SIGKILL, and SIGTERM.

Pauses program execution for given time in seconds.

Stops program execution with optional exit status stat. The exit status may be STOP_SUCCESS or STOP_FAILURE.

Counts occurences of character a in str, with optional quoting (a in between quote characters is not counted).

Returns the number of line breaks in string.

Returns the number of occurences of string s2 in string s1.

Generic number to string converter.

Returns .true. if given allocatable string is not passed, not allocated, or contains only white spaces.

Returns .true. if given string is present and not empty.

Returns .true. if all characters is given string are printable ASCII characters.

Converts given string to lower case.

Replaces character a in str with b.

Splits a string by a given delimiter into an array of strings.

Returns .true. if string a starts with string b.

Generic string to number converter.

Returns given string in lower case.

Returns given string in upper case.

Allocates string type to empty character of length 0 or n, if not allocated already.

Deallocates allocatable character inside of string type.

Converts given string to upper case.

Returns .true. if given sync types are equal.

Returns .true. if given sync data is valid.

Returns name of synchronisation type.

Prints sync type to standard output or given file unit.

Returns synchonisation type from given name.

Returns .true. if given sync type enumerator is valid. The type SYNC_TYPE_NONE is invalid.

Turns current running program into a daemon. On FreeBSD, it is probably easier to run the process through daemon(8) instead.

Returns system error string from strerror(3). If error is not passed, this function used errno(2) as error code.

Forks process and returns PID.

Returns the relative path of the executable.

Returns uname information (operating system, hostname, …).

Returns system uptime in time [sec]. On error, argument error is E_SYSTEM.

Waits for child process and returns PID.

Returns .true. if given targets are equal.

Returns .true. if given target type elements are valid.

Prints target to standard output or given file unit. If not unit is passed, the target will be written to standard output.

Returns .true. if the state of the given target type is known.

Returns the name of the known target state as an allocatable character string, or unknown if the state is not known.

Generic dummy type generator.

Generates dummy beat data type.

Generates dummy log data type.

Generates dummy sensor node data type.

Generates dummy observation data type.

Generates dummy request data type.

Generates dummy sensor data type.

Generates dummy target data type.

Runs all tests in given array tests, returns test states in array stats.

Returns .true. and outputs a debug message if environment variable of name env_var is set to 1.

Creates POSIX thread. The function returns E_SYSTEM on error.

Join POSIX thread, and optionally returns value as C pointer.

Returns 32-characters long time stamp string in ISO 8601/RFC 3339 of the form 1970-01-01T00:00:00.000000+00:00. Optional argument zone sets the time zone and has to be of the form [+|-]hh:mm, for example, +00:00 or -01:00.

Returns time delta type time_delta from Unix time stamp in seconds.

Converts time_delta_type to string of format [d days ][h hours ][m mins ][s secs].

Returns the time difference between time1 and time2 as 8-byte integer seconds [sec]. The function does not validate the time stamps. Make sure to only pass valid values. On error, the result seconds is huge(0_i8).

Converts Unix epoch to integer or string representation.

Returns .true. if given time stamp follows the form of ISO 8601. The time stamp does not have to be complete to be valid, unless strict is .true.. Then, argument time must be 32-characters long. Otherwise, the minimum length of a time stamp to be valid is 4 characters, the maximum is 32 characters.

Returns current time in mseconds as 8-byte integer (Unix Epoch). On error, the result is 0.

Returns current date and time as 32-characters long string in ISO 8601/RFC 3339 format (1970-01-01T00:00:00.000000+00:00), and microsecond resolution.

Returns current date and time as 31-characters long string in RFC 2822 format.

Returns current date and time values as strings in given dummy arguments.

Strips the microseconds part of the given ISO 8601 time stamp and returns a 25-characters long string. The function does not validate the time stamp for performance reasons. Make sure that only a valid 32-characters long ISO 8601 time stamp is passed in time.

Converts ISO 8601 time stamp time into Swatch Internet Time (.beat time) in the form @1000.00 in beats. One beat is equivalent to one decimal minute in the French decimal time (1 min 26.4 sec in Solar time).

Returns time stamp as 26-characters long string in human-readable format. Converts the given ISO 8601 time stamp time in format 1970-01-01T00:00:00.000000+00:00 to format 1970-01-01 00:00:00 +00:00. The argument time is not validated. Make sure to only pass valid values.

Converts 32-characters long ISO 8601/RFC 3339 time stamp to Unix time stamp (Epoch). The function calls timegm() internally (not in POSIX, but available since 4.3BSD), and then removes the time zone offset. The returned Epoch is always in UTC. The output does not contain microseconds.

Returns current time zone as five characters long string, for example, +0000.

Returns current time zone as six characters long string (ISO format), for example, +00:00.

Returns elapsed time between timer start and stop in seconds as 8-byte real. The result is 0.0 if the timer has not been stopped yet.

Starts the timer by setting clock rate and first clock count.

Stops the timer and optionally returns result as 8-byte real in duration.

Alias for procedure.

Converts type to 8-byte real (for response values).

Converts unsigned integer to signed integer.

Converts signed integer to unsigned integer.

Alias for procedure.

Calculates coordinates (x, y, z) out of horizontal direction, vertical angle, and slope distance to a target point using a 3-dimensional polar transformation.

Returns baud rate enumerator from numeric value. If the value is invalid, returns 0 by default and sets optional argument error to E_INVALID.

Returns byte size enumerator from numeric value. If the value is invalid, returns 0 by default and sets optional argument error to E_INVALID.

Closes file descriptor.

Flushes TTY input and output buffer. Returns E_INVALID if the passed tty type is invalid, or E_SYSTEM if the system call failed.

Return .true. if TTY is connected, else .false..

Returns .true. if given baud rate value is valid, else .false..

Returns .true. if given byte size value is valid, else .false..

Returns .true. if given parity value is valid, else .false..

Returns .true. if given stop bits value is valid, else .false..

Returns .true. if given timeout value is valid, else .false..

Opens TTY/PTS device in set access mode and applies serial port attributes. The arguments baud_rate, byte_size, parity, and stop_bits must be valid enumerators.

Returns parity from character string (none, even, odd). If the parity is not recognised, returns 0 by default and sets optional argument error to E_INVALID.

Generic TTY read function.

Reads single byte from file descriptor.

Reads from TTY into buf until delimiter del occurs. The number of bytes read is returned in n.

Reads TTY response into request. The request delimiter is unescaped. The response is escaped before being stored in the request.

Sets terminal attributes.

Sets TTY to blocking or non-blocking.

Sets timeout of given TTY. A timeout of 0 results in blocking read without timeout. The minimum timeout is 0 seconds, the maximum is 25 seconds.

Returns stop bits enumerator from numeric value. If the value is invalid, returns 0 by default and sets optional argument error to E_INVALID.

Generic TTY write function.

Writes given string to TTY. Returns E_WRITE on error. The function may cause an access violation if nbytes is greater than the length of bytes. Returns E_WRITE on error.

Writes given request to TTY. The function unescapes the request string. The function returns E_WRITE on error.

Returns type from given name. If name is longer than TYPE_NAME_LEN, only the characters from 1 to TYPE_NAME_LEN are compared.

Returns .true. if given type enumerator is valid. TYPE_NONE is an invalid type.

Converts unsigned 2-byte integer to signed 4-byte integer.

Converts unsigned 4-byte integer to signed 8-byte integer.

Converts angle to degrees.

Converts angle to gradians.

Converts angle to radiants.

Returns unit type.

Returns unit value.

Alias for procedure.

Pauses program execution for given time in useconds.

Generates random UUIDv4 (RFC 4122) in hexadecimal format, i.e., without hyphens (32 characters long). The PRNG has to be seeded before the first invocation by calling dm_init() once.

Returns given UUID with hyphens, i.e., turns string 00000000000000000000000000000000 into 00000000-0000-0000-0000-000000000000. The function does not validate the passed indentifier.

Returns UUIDv4 with hyphens (36 characters long). The PRNG has to be seeded before the first invocation by calling dm_init() once.

Returns .true. if given UUID in hex format is a valid UUIDv4. Only lower-case letters are valid.

Generic DMPACK version output routine.

Generic DMPACK version formatters.

Generic serialisation and compression function.

Serialises derived type to namelist format and compresses it depending on compression type z. The serialised and compressed result is returned in output. The argument output_len will equal the length of output. The function returns E_INVALID if type is unsupported.

Serialises derived types types to namelist format and compresses them depending on compression type z. If z is Z_TYPE_ZSTD, the function uses a Zstandard compression context. The serialised and compressed results are returned in output. The function returns E_INVALID if types is unsupported. On error, not all strings of output may be allocated.

Generic validation function.

Returns compression type enumerator from HTTP content encoding:

Returns compression type enumerator from name. The function returns Z_TYPE_INVALID if the name is not a valid type name.

Returns .true. if the given compression enumerator z is valid. The type Z_TYPE_NONE is a valid type, and Z_TYPE_INVALID is invalid.

Returns compression type name as allocatable string.

Returns allocatable HTTP content type string from compression type enumerator. The function returns an empty string for types Z_TYPE_INVALID and Z_TYPE_NONE.

Generic deserialisation and decompression function.

Compresses input string using the zlib utility function.

Uncompresses input string using the zlib utility function. The output buffer must be large enough to hold the uncompressed result. Returns E_ZLIB if the decompression failed.

Generic Zstandard compression function.

Destroys Zstandard context created with zstd_compress_multi() or zstd_uncompress_multi(). The function returns E_ZSTD on error.

Returns default zstd compression level.

Returns maximum zstd compression level.

Returns minimum zstd compression level.

Generic Zstandard decompression function.

Returns zstd library version as allocatable string.

Registers the Lua parameters and interfaces of the DMPACK API, including the GeoCOM API. This function is invoked automatically by Lua 5.4 if library libdmpack.so is loaded.

Returns whether requests are equal.

Returns whether observations or observation views are equal.

Returns whether logs are equal.

Returns whether sensors are equal.

Returns whether nodes are equal.

Returns whether persons are equal.

Returns whether sync types are equal.

Returns whether heartbeats are equal.

Returns whether requests are equal.

Returns whether api status types are equal.

Returns whether targets are equal.