Command Reference

omrpc-register

omrpc-cc

omrpc-gen

omrpc-register

• NAME

  omrpc-register - operations about OmniRPC's registry.
  

• SYNOPSIS

  omnrpc-register [-path reg_path]
        [-show|-help|-clear|[-register|-remove] rex_prog]
  

• DESCRIPTION

  Adds registry of remote executable programs, and removes them from the registry. Shows the current registry.

• OPTIONS

  -path reg_path

  Specifies path to the registry. The default registry path is "$HOME/.omrpc-registry".

  -show

  Shows information about the current registry.

  -clear

  Removes all information about current registry.

  -register rex_prog

  Registers the remote executable program rex_prog on remote host.

  -remove rex_prog

  Removes the remote executable program rex_prog from the registry.

  -help

  Displays help and exits.

omrpc-cc

• NAME

  omrpc-cc - Compile driver for OmniRPC program.
  
   SYNOPSIS
  omrpc-cc [options] [file.idl][file.c ...]
  
  
   DESCRIPTION
  
  The compile driver for the OmniRPC program.
  Links to necessary OmniRPC library. And, if the IDL file is in
  the arguments, creates remote executable program which corresponds to  it.
  
   When you create client program, the command is used like a C
   compiler.  For example:
  omrpc-cc -o foo foo.c goo.o
  
  Like a C compiler, this compiles foo.c, and links to goo.o, then the executable
  file foo is created.
  During this time, this command automatically sets the library and include file, which are
  necessary for OmniRPC. Additionally, if "-o" is not specified,  like a C
  compiler, the object file is "a.out."
  
  
  
  If the IDL file  has an ".idl" extension in the argument file, this
  command generates the OmniRPC remote executable program from this file. 
  This program name takes on the extension ".rex", for instance,
  omrpc-cc bar.idl goo.o
  
  In this case, bar.rex is generated from bar.idl, and goo.o is the library
  linked to a remote execution program.
  
  
   OPTIONS
  
   -c 
   Compiles and generates the object file, but not the link.
  
   -c 
  
  Specifies object files.
  
   -llib_dir 
  
  Specifies the path to the library's directory.
  
   -show 
  
  Shows the command which should be executed. Execution is not carried out.
  
   -echo 
  
  Shows the command which should be executed.
  
   -liner link_command 
  
  Specifies the command to the link.
  If this option is omitted, the default command is cc, which is a
  driver of the C compiler. For example, if you use Fortran, you can
  specify f77 as a linker.
  
  
  
  
  

omrpc-gen

• NAME

  omrpc-gen - A program to generate OmniRPC's stub.
  
   SYNOPSIS
  omrpc-gen [file.idl][file.c]
  
  
   DESCRIPTION
  
  Generates the stub program file.c (in C language) from the IDL file
   file.idl.
  If the IDL file is omitted, the input is from STDIN. If the stub program argument
  is omitted, the output is STDOUT.
  Usually IDL files uses the file extension ".idl". The source file of
  stub program use the extension  ".rex.c". The remote executable program
  which  is compiled from the stub program, use the extension ".rex".
  
  
  This program usually call from the OmniRPC's compile driver, so you
  can use it directly.
  If you compile the stub source program directly, you should specify
  the include directory, which is below  the install directory, as the include
  path.
  And when you create the remote executable program, you should link the
  library for the stub (libomrpc_stub.a and libomrpc_io.a).
  If you install OmniRPC at the INSTALL_DIR, you should compile in the
  way shown below.
  
  cc -o foo.rex -IINSTALL_DIR/include foo.rex.c
      ... -LINSTALL_DIR/lib -lomrpc_stub.a -lomrpc_io