raw_shift
Section: WIN SYSTEM (1W)
Updated: 2002.5.31
Index
Return to Main Contents
NAME
raw_shift - Right shift of RAW format data by desired numbers of bits
SYNOPSIS
raw_shift
inkey
outkey
shmsize
bits
[
chfile
[
logfile
]]
DESCRIPTION
Raw_shift loads win format data cyclically written in a shared memory segment identified by a key
inkey
and shifts all the samples of all the channels to the right by
bits
bits and writes the data to another shared memory segment identified by another key
outkey.
If a channel file
chfile
is given, however, only the data of the channels listed in this file will be written shifted to the right while the data of any other channels are bypassed.
If the channel file name is prefixed with '+,' the channels listed in this file will be written shifted to the right while any other channels are just copied to the output.
Alternatively, if the channel file name is prefixed with '-,' the channels listed in this file will be just copied to the output while any other channels are written shifted to the right.
If the shared memory segment with the key
outkey
does not exist, a shared memory segment with a size of
shmsize
(KB) will be created. If it already exists but has a size smaller than
shmsize
(KB), an error will occur.
The shared memory key is a 32-bit integer value.
When log file name
logfile
is specified, operation log is set here. When it is not specified, log information is sent to the standard output. The log file is opened/closed in each write.
The channel file is a text file that hexadecimally lists channel numbers, one for each line. In each line, only the first item is read, while the subsequent items delimited by blanks or tabs are all ignored. Any lines starting with '#' are also ignored.
When receiving a hang-up signal, the raw_shift process rereads the channel file.
The format in the shared memory
inkey
can be either a chronologically sorted one (Cf. order(1W)) or otherwise (Cf. recvt(1W)). The format in the shared memory
outkey
will be the same as that of
inkey.
When raw_shift is initiated without argument, brief usage is displayed.
OPTIONS
- None
-
SOURCE
- `raw_shift.c'
-
SEE ALSO
winformat(1W), order(1W), recvt(1W)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- SOURCE
-
- SEE ALSO
-