NAME

file-iodp - set IODP environment for file handles

SYNOPSIS

file-iodp [options] filename program [arguments]

DESCRIPTION

file-iodp opens a file and runs program with the remaining arguments. In an alternative operation mode file-iodp may just set the IODP environment variables for an existing file handle and run program.

options is a is a series of getopt or getopt_long style options. See below for more information.

OPTIONS

File options:

Note: The default is to open the file read-write, in non-truncating overwrite mode (like O_RDWR does).

-r, --rdonly: Open the file read-only.
-w, --wronly: Open the file write-only.
-a, --append: Append to end of file. Do not truncate.
-c, --create: Create new file, if needed.
-e, --exclusive: Fail if file already exists.
-t, --truncate: Truncate file.
-f, --fifo: Create fifo, not file.
-m, --mode=MODE: Set access rights of the file to MODE. The default is 0644 for files and 622 for fifos.
-R, --unlink: Remove existing file. This will be done before any other operation.
-n, --reuse=FD: Reuse existing file handle FD, do not open another file. file-iodp will act as if it opened the file and got the file handle FD in return.

Child program options:

-C, --chroot=DIR

Change the working directory to DIR. Then change the root directory of the process to . (the current directory). This will be done after the socket has been created and before changing the group or user ID.

-F, --fd=N

Move socket handle to file descriptor N.

N is an integer in the range from 0 to a system ``dependent limit. The default is to not move it. Note that moving the socket to file descriptor 2 may disturb the output of error messages.

-g, --gid=GID

Group ID to change to.

tcpsocket will switch to that group id after the socket has been set up. GID has to be a positive integer.

-u, --uid=UID

User ID to change to.

tcpsocket will switch to that user id after the socket has been set up. UID has to be a positive integer.

-U, --uidgid

The same as -u $UID -g $GID.

Usually used together with envuidgid.

Data-gathering options:

-y, --symbolic-name=NAME

Use NAME as symbolic socket name.

This is used for $IODP_n_SYMNAME, and may be used by IODP compliant application in an application dependant way. The default is to not set it.

Verbosity options:

-1

Print the local port number to the standard output.

-q, --quiet

Quiet. Do not print error messages.

-Q

Print error messages.

This is the default.

-v, --verbose

Verbose. Print error and status messages.

--version

Show version information.

--help

Show a list of options or the long help on one.

The use with an argument shows the long helptext of that option, without an argument it will list all options.

--longhelp

Show longer help texts for all or one variable

The use with an argument shows the long help for this option, without arguments it shows the long description of all options.

ENVIRONMENT

tcpsocket sets the environment variables documented in the iodp-tcp specification.

EXAMPLES

        file-iodp -r /proc/kmsg \
        /usr/bin/logger -t kernel

BUGS

unknown.

AUTHOR

Uwe Ohse