Module hostio

Read a string containing a representation of a 64-bit decimal integer from the keyboard, and to echo it to standard out.

The integer may commence with a + or a - sign. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Provide a general purpose routine for interactively asking a user of a program a question requiring only a one character answer.

After the prompt and possibly the printable replies, " ? " is output and a valid key is waited for from the keyboard; invalid keys are ignored.

Test for the occurrence of an error on the specified stream.

Read a single character from the keyboard, without waiting for one if there is none.

The key is not echoed to the screen.

Return the contents of an environment variable from whatever host is being used.

The largest size the returned contents of an environment variable can be is limited by the functionality of the server, not by this routine.

Read a line from the specified input stream.

Characters are read until a newline sequence is found, the end of the file is reached, or the number of characters is not less than sp.max.readbuffer.size. If a newline sequence is found, it is not included in data.

Act as two almost independent buffers.

The dependence of the buffers is given by the fact that the number of communications through one buffer ( buffer2 ) must match the number through the other buffer ( buffer1 ) before the routine will terminate. No more than sp.max.packet.data.size bytes can be buffered in each of the buffers.

Multiplex any number of pairs of SP protocol channels onto a single pair of SP protocol channels, where the multiplexing is overlapped so that output through this routine can continue independently of the receipt of replies.

There is a relative priority to the input channels: from.user[ i ] is of higher priority than from.user[ j ] where i < j.

It is an error if the size of from.user is different to that of to.user. It is permissible for the size of from.user ( and hence to.user ) to be zero. The maximum number of bytes that can be channelled through this routine in each direction is sp.max.packet.data.size. It is assumed that replies for messages are received in the same sequence as the messages are sent.

Read the server command line and parse it for specified options and associated parameters.

Write an unlimited number of bytes to a stream.

Read a string containing a representation of a decimal integer from the keyboard, and to echo it to standard out.

The integer may commence with a + or a - sign. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Terminate the server.

Terminate the server.

Open a temporary file in spm.new.update mode.

The file will be opened in the current directory. The file name of the temporary file is chosen as follows: the first name tried is TEMP00; if there already exists such a file then TEMP01 is tried; if there already exists such a file then TEMP02 is tried; etc. up to TEMP99 when, if such a file exists then TEM100 is tried, and so on up to TEM999, at which point, if such a file exists, TE1000 is tried, and so on up to TE9999, which is the last name tried, i.e. a maximum of 10,000 possible temporary files can be created by this routine.

Flush the specified output stream.

To flush means to write out any internally buffered data to the stream that it is associated with. The stream remains open.

Multiplex any number of pairs of SP protocol channels onto a single pair of SP protocol channels.

It is an error if the number of channels in from.user is not equal to that in to.user. It is permissible for from.user ( and hence to.user ) to be null arrays. No more than sp.max.packet.data.size bytes can be buffered as they passes through this routine. Primary input to this routine must be on the guard input channels from.user[ i ] or stopper. Input on from.user[ i ] is stored, output on ts, then a reply is expected on fs; this reply is stored and then output on to.user[ i ], and all this must finish before any new input can be received on any of the from.user channels or stopper. To attempt some degree of fairness, there is a heirarchy of priorities from from.user with index i for SIZE from.user, using modulo SIZE from.user on the indexes, with i starting from 0 and incrementing by one after each input accepted.

Write a double precision real as decimal ASCII characters to a stream.

Behaves as an invalid process if the string to write is longer than 30 characters.

Write a double precision real as decimal ASCII characters to standard out.

Behaves as an invalid process if the string to write is longer than 30 characters.

Read an integer in either ( two's complement ) hexadecimal form or in decimal form from the keyboard, and to echo it to standard out.

The hexadecimal number must begin with one of '#', '$' or '%'; a sign is not allowed ( nor necessary since the most significant bit indicates the sign ). A '#' and '$' mean exactly the same thing: the following digits form a hex integer. A '%' means add the given hex integer to MOSTNEG INT using modulo arithmetic to give the result. Both upper and lower case hex digits are permissible. A sign is allowed in the first character position if it is a decimal integer that is entered. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Convert the number of seconds since the midnight before 1st January 1970 into the associated time and date.

Format a time and date given in the form of six integers.

Convert the number of seconds since the midnight before 1st January 1970 into a formatted time and date

Give the time and date, in the form of six integers, of when this routine was called.

If the time and date are unavailable all elements of date are set to zero. Local time is used.

Give the time and date, in formatted form, of when this routine was called.

If the time and date are unavailable string is filled with spaces. Local time is used.

Perform a general purpose open file for reading.

This procedure performs the following actions: 1. An attempt is made to open the file as given by filename ( so if there is no directory part to filename the current directory will be tried ); 2. If the attempt in 1 is not successful and there is no explicit directory part to filename, the path is searched for the file.

Return identification information about the server and the host that it is running on.

If any of the information ( except result ) has the value zero then that information is not available. The parameter version cannot distinguish between e.g. 1.41 and 1.42.

Return identification information about the server and the host that it is running on.

If any of the information has the value zero then that information is not available. The parameter version cannot distinguish between e.g. 1.41 and 1.42.

Test whether the specified stream has end of file status or not.

Delete the specified file.

No path environment variable is used; what is in name is all that is considered.

Write to the specified file stream a 64-bit integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative field width is an error.

Write to standard out a 64-bit integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative field width is an error.

Write a single precision real as decimal ASCII characters to a stream.

Behaves as an invalid process if the string to write is longer than 24 characters.

Write a single precision real as decimal ASCII characters to standard out.

Behaves as an invalid process if the string to write is longer than 24 characters.

Write a line to the specified output stream.

A newline sequence is added to the end of the bytes to be written.

Read an unlimited number of bytes from a stream.

Read a 32-bit integer in ( two's complement ) hexadecimal form from the keyboard, and to echo it to standard out.

The hexadecimal number must begin with one of '#', '$' or '%'; a sign is not allowed ( nor necessary since the most significant bit indicates the sign ). A '#' and '$' mean exactly the same thing: the following digits form a hex integer. A '%' means add the given hex integer to MOSTNEG INT32 using modulo arithmetic to give the result. Both upper and lower case hex digits are permissible. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Rename the specified file.

Read an integer in ( two's complement ) hexadecimal form from the keyboard, and to echo it to standard out.

The hexadecimal number must begin with one of '#', '$' or '%'; a sign is not allowed ( nor necessary since the most significant bit indicates the sign ). A '#' and '$' mean exactly the same thing: the following digits form a hex integer. A '%' means add the given hex integer to MOSTNEG INT using modulo arithmetic to give the result. Both upper and lower case hex digits are permissible. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Test for the existence of a file.

Act as a communication buffer.

No more than sp.max.packet.data.size bytes can be buffered. Primary input to this routine must be on the guard input channels from.user or stopper. Input on from.user is stored, output on ts, then a reply is expected on fs; this reply is stored and then output on to.user, and all this must finish before any new input can be received on from.user or stopper.

Read a limited number of bytes from a stream.

Read a line from the keyboard, echoing it to standard out.

The line to be read is considered terminated by a carriage return, ie ASCII ^M, which has value #0D = 13. This carriage return is not included in the line, and nor is a newline ( ASCII ^J, #0A = 10 ) if present in the input. Carriage return and newline are not echoed. If an error occurs whilst reading the line this routine terminates immediately.

Read a 64-bit integer in ( two's complement ) hexadecimal form from the keyboard, and to echo it to standard out.

The hexadecimal number must begin with one of '#', '$' or '%'; a sign is not allowed ( nor necessary since the most significant bit indicates the sign ). A '#' and '$' mean exactly the same thing: the following digits form a hex integer. A '%' means add the given hex integer to MOSTNEG INT64 using modulo arithmetic to give the result. Both upper and lower case hex digits are permissible. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Write a string to standard out.

Write a single character to standard out.

Write a string appended by a newline to standard out.

The newline sequence is appended by this routine.

Write a newline to standard out.

Retrieve the local and UTC time from the host system.

Both times are expressed as the number of seconds that have elapsed since midnight on the 1st of January, 1970, and are given as unsigned INT32s UTC time used to be known as Greenwich Mean Time ( GMT )

Retrieve the local and UTC time from the host system.

Both times are expressed as the number of seconds that have elapsed since midnight on the 1st of January, 1970, and are given as unsigned INT32s UTC time used to be known as Greenwich Mean Time ( GMT )

Return the contents of the root transputer's memory as peeked from the transputer when the server was invoked with the analyse option.

If offset + (SIZE data) is larger than the total memory peeked then only those bytes from offset up to the end of that memory peeked are returned in data. If both offset and SIZE data are zero, the routine fails if the memory was not peeked, succeeds otherwise.

Write an integer as hexadecimal ASCII characters preceded by the '#' character to a stream.

Write an integer as hexadecimal ASCII characters preceded by the '#' character to standard out.

Open a file.

No path environment variable is used to locate the file; what is in name is all that is used ( cf. so.popen.read )

Write a 64-bit integer as hexadecimal ASCII characters preceded by the '#' character to a file.

Write a 64-bit integer as hexadecimal ASCII characters preceded by the '#' character to standard out.

Write a 32-bit integer as hexadecimal ASCII characters preceded by the '#' character to a file.

Write a 32-bit integer as hexadecimal ASCII characters preceded by the '#' character to standard out.

Read a string containing a representation of a double precision real in occam syntax ( though a + or - is allowed as first character ) from the keyboard and to echo it to standard out.

The number typed at the keyboard must be terminated by pressing 'RETURN'.

Write an unlimited number of bytes to a stream.

Read a string containing a representation of a 32-bit decimal integer from the keyboard, and to echo it to standard out.

The integer may commence with a + or a - sign. The number typed at the keyboard must be terminated by pressing 'RETURN'.

Return the command line passed to the server on invocation.

Set the file position for the specified stream.

Send an SP protocol packet.

Receive an SP protocol packet.

Write to the specified file stream an integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative value is an error.

Write to standard out an integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative field width is an error.

Read a line from the keyboard without echoing it.

The line to be read is considered terminated by a carriage return, ie ASCII ^M, which has value #0D = 13. This carriage return is not included in the line, and nor is a newline ( ASCII ^J, #0A = 10 ) if present in the input. If an error occurs whilst reading the line this routine terminates immediately.

Execute a command on the host system.

Write a string to a stream.

Write a single character to a stream.

Write a string appended by a newline to a stream.

The newline sequence is appended by this routine.

Write a newline to a stream.

Write to the specified file stream a 32-bit integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative field width is an error.

Write to standard out a 32-bit integer as decimal ASCII digits, padded out with leading spaces and an optional sign to the specified field width.

If the field width is too small for the number, then it is widened as necessary; a zero value for the field width will give minimum width; a negative field width is an error.

Read a string containing a representation of a single precision real in occam syntax ( though a + or - is allowed as first character ) from the keyboard and to echo it to standard out.

The number typed at the keyboard must be terminated by pressing 'RETURN'.

Multiplex any number of pairs of SP protocol channels onto a single pair of SP protocol channels, where the multiplexing is overlapped so that output through this routine can continue independently of the receipt of replies.

It is an error if the size of from.user is different to that of to.user. It is permissible for the size of from.user ( and hence to.user ) to be zero. The maximum number of bytes that can be channelled through this routine in each direction is sp.max.packet.data.size. It is assumed that replies for messages are received in the same sequence as the messages are sent. To attempt some degree of fairness, there is a heirarchy of priorities from from.user with index i for SIZE from.user, using modulo SIZE from.user on the indexes, with i starting from 0 and incrementing by one after each input accepted.

Close a stream.

Before closing the stream unwritten data is flushed or any unread buffered input is discarded.

Return the current file position for the specified stream.

Multiplex any number of pairs of SP protocol channels onto a single pair of SP protocol channels.

There is a relative priority to the input channels: from.user[ i ] is of higher priority than from.user[ j ] where i < j.

It is an error if the number of channels in from.user is different to that in to.user. It is permissible for the number of channels in from.user ( and hence also to.user ) to be zero. No more than sp.max.packet.data.size bytes can be buffered as they passes through this routine. Primary input to this routine must be on the guard input channels from.user[ i ] or stopper. Input on from.user[ i ] is stored, output on ts, then a reply is expected on fs; this reply is stored and then output on to.user[ i ], and all this must finish before any new input can be received on any of the from.user channels or stopper.