fmu(1) CLIX fmu(1)
NAME
fmu - Runs a network file management utility
SYNOPSIS
fmu [-cefaiqrsvx] [host.user[.[password]] [command]]
FLAGS
-a Inhibits automatic compression when transferring files. By default,
if fmu detects a slow transfer rate, it automatically compresses the
file before sending it.
-c Forces the output file to be created contiguously. This feature is
valid only if supported by the receiving system.
-e Echos all commands before executing them. This feature is useful to
view commands if stdin is redirected from a file.
-f Forces the output file to be created in fixed-length, 512-byte
records. This feature is valid only if supported by the receiving
system.
-i Designates files being transferred as Interactive Graphics Design
System (IGDS) files. This flag is equal to specifying both the -c
and -f flags. This feature is valid only if supported by the
receiving system.
-p Executes the login profiles (/etc/profile and the user's .profile) on
the remote system. If either profile requires input, fmu does
succeed in connecting to the remote system.
-q Suppresses the FMU> prompt. This is useful if stdin is redirected
from a file.
-r Displays the fmu release date (version number).
-s Turns on software checksumming when transferring files.
-v Turns on verbose mode. When transferring files, fmu displays
statistics of the files being transferred.
-x Turns on compression when transferring files.
DESCRIPTION
The fmu command runs a network file transfer and remote command utility.
The host parameter is either a nodename or an Ethernet address. Once the
remote connection is established, the privileges and working directory are
the same as if a login for the specified user occurred on the remote
2/94 - Intergraph Corporation 1
fmu(1) CLIX fmu(1)
system.
For security, fmu requires a login, specified by user, on the remote
system. If the login on the remote system has a password, password must
be supplied. If a period (.) followed by a <Return> or a blank space is
specified after user, fmu prompts for a password (with echoing disabled).
Otherwise, the word immediately following the period is used as the
password. Note that including a password on the command line is a serious
security risk. The command parameter can be specified on the command line
following either the password or the period and blank space.
The fmu command has interactive and noninteractive modes. To use
noninteractive mode, host, user, and command must be specified on the
command line. Pipes can also be used on the command line.
The command parameter specifies a function to be performed. Only as many
characters as needed to uniquely identify a command need to be specified.
Interactive mode is entered when command is not specified. After entering
interactive mode, an FMU> prompt appears.
The following commands are available:
receive in [out]
Receives a file or multiple files from the remote host. The in
parameter represents the file(s) on the remote host to be received
and out is the name of the output file or directory on the local
machine. If in consists of multiple files, out must be a
directory. If out is not specified, the current directory is used.
If this command is specified on the command line, received data can
be sent to stdout if out is specified with a dash (-).
send in [out]
Sends a file or multiple files to the remote host. The in
parameter represents the file(s) on the local machine to be sent
and out is the name of the output file (or directory) on the remote
host. If in consists of multiple files, out must be a directory.
If out is not specified, the current directory is used. If this
command is specified on the command line, data to be sent can be
received from stdin if in is specified with a dash (-).
cat file ...
Displays the remote files to stdout on the local machine.
connect nodespec
Terminates the present connection (if any) and establishes a
connection with the remote system specified by nodespec. The
nodespec syntax has the same form as host.user[.[password]]
specified on the command line.
ls [dir]
2 Intergraph Corporation - 2/94
fmu(1) CLIX fmu(1)
Lists the contents of the dir directory on the remote host. The
dir argument is passed to the directory listing program on the
remote host, which checks for proper syntax. If dir is not
provided, the current directory is used.
rm file ...
Removes the specified files from the remote host.
cd [dir]
Changes to the dir directory on the local machine. If dir is not
provided, the environment variable $HOME is used.
rcd [dir]
Changes to the dir directory on the remote host. If dir is not
provided, the environment variable $HOME on the remote host is
used.
command string
Executes string on the remote host. All stdout written by the
remote command is written to stdout on the local machine.
!command
Executes command on the local machine.
help [arg]
Displays a one-line summary of arg. If arg is not a valid command,
all available commands are listed.
exit Closes the current connection (if any) and exits.
set option
Sets the specified option. Valid options are as follows:
[no]checksum
Functions the same as the -s flag.
[no]compress
Functions the same as the -x flag.
[no]contiguous
Functions the same as the -c flag.
[no]echo
Functions the same as the -e flag.
[no]fixed
Functions the same as the -f flag.
[no]igds
Functions the same as the -i flag.
2/94 - Intergraph Corporation 3
fmu(1) CLIX fmu(1)
[no]inhibit
Functions the same as the -a flag.
[no]quiet
Functions the same as the -q flag.
[no]verbose
Functions the same as the -v flag.
type file ...
Synonym for cat.
directory [dir]
Synonym for ls.
delete file ...
Synonym for rm.
chdir [dir]
Synonym for cd.
rchdir [dir]
Synonym for rcd.
Wildcards can be used when specifying files. However, for output files,
no partial wildcard specifications are accepted. For example, an asterisk
(*) is a valid output file specification, but *.txt is not. Wildcards
entered on the command line must be quoted to prevent the shell from
expanding them.
While in interactive mode command-line recall and editing features are
available. The key definitions are as follows:
<Return>
Recalls and executes the most recent command.
<Ctrl-A>
Goes to the beginning of the line.
<Ctrl-E>
Goes to the end of the line.
<Ctrl-D>
Deletes the character the cursor is on. If no command is being
edited, this key sequence terminates the session.
<Ctrl-P>
up arrow key
Recalls the previous command.
<Ctrl-K>
4 Intergraph Corporation - 2/94
fmu(1) CLIX fmu(1)
Deletes all characters to the right of the cursor.
<Ctrl-N>
down arrow key
Recalls the next command.
<Ctrl-B>
left arrow key
Moves the cursor to the left one position.
<Ctrl-F>
right arrow key
Moves the cursor to the right one position.
<Delete>
Deletes the character to the left of the cursor.
kill key
Deletes the entire line.
eof key
<Return>
<Line Feed>
Designates the end of a command. The fmu command then executes the
line contents.
EXAMPLES
1. To send all files beginning with foo and ending with .c to /tmp on the
remote host abc, enter:
fmu abc.guest send 'foo*.c' /tmp
The foo*.c must be quoted because the asterisk (*) is a shell special
character.
2. To send a cpio backup to the file backupfile on the remote host backup
using stdin, enter:
find src -print | cpio -ov | fmu backup.guest send - backupfile
3. To restore the previous example, enter the following command:
fmu backup.guest rec backupfile - | cpio -iv
4. The following example is an interactive session with fmu to execute
the who command on the remote host:
$ fmu 08-00-36-23-08-00.remote.guest
2/94 - Intergraph Corporation 5
fmu(1) CLIX fmu(1)
FMU> com who
root console Dec 7 17:12
FMU> exit
$
DIAGNOSTICS
For more information on diagnostic messages, refer to the
/usr/ip32/inc/incerr.msg file.
INC_FM, Error creating output file
INC_FM, Error closing output file
Indicates the recipient file of the transfer request cannot be
opened or closed. Check to ensure the file's receiving directory
exists, has space available for the file, and that you have write
privileges to the directory.
INC_FM, Syntax error
Indicates a syntax error either in using the set command or in the
specified filename.
INC_FM, File write error
Indicates an error while trying to write to a file. Check the
privileges on the error you are writing the file to.
INC_FM, Error opening file
Indicates the file to be transferred cannot be opened. Check the
protection of the file to ensure you have read access to it.
INC_FM, Invalid or nonexistent directory
Indicates syntax errors in the specified directory, or the
directory specified does not exist.
INC_FM, Ambiguous output file specifications are invalid
Indicates errors in output file specifications. Do not use partial
wildcards in output file specifications.
NOTES
If the remote command requires input, fmu hangs.
The fmu command does not handle the binary output of a remote command
(such as tar or cpio).
CAUTIONS
Including a password on the command line is a serious security risk. It
is recommended that you enter the password only at the password prompt,
when echoing is disabled.
6 Intergraph Corporation - 2/94
fmu(1) CLIX fmu(1)
EXIT VALUES
The fmu command exits with a value of 0 if successful. If unsuccessful,
it exits with a value of 1.
RELATED INFORMATION
Commands: cat(1), fmus(8), ls(1), rm(1), rpipe(1), sh(1)
2/94 - Intergraph Corporation 7