`RCLoad`

Load commands from a file

RCLoad

Shortest form: rcl.

Run the commands in a script file. Any arguments after the file name are available in the script as $1, $2, …, in a scope of their own. Comments, line continuation, error handling (the RCError option) and where the file is looked up are described in Scripting. A missing file prints rcload: Error: file not found: <file>.

The same mechanism runs when you type an unknown command <word>: if the RCLoad option is on (the default), the shell tries rcload <word>.soc.

Files are read inside the syncd container. The FTP form in the built-in help (user%password@host:) does not work on SONiC. Whether a script is safe depends on what it contains.

Hardware-validated

drivshell> rcload /tmp/show-ports.soc ce0
                 ena/        speed/ link auto    STP                  lrn  inter   max   cut   loop
           port  link  Lns   duplex scan neg?   state   pause  discrd ops   face frame  thru?  back   encap
       ce0(  1)  !ena   4  100G  FD   SW  No   Forward         Untag    F    CR4  9122    No          IEEE

Built-in help

Parameters: <file> [parameters]
    Load commands from a file until the file is complete or an error
    occurs. If optional parameters are listed after <file> they are
    pushed as local variables for the file processing. For example:
         rcload fred a bc will result in the variables:
            $1 = a
            $2 = bc
        during processing of the file.
    For platforms where FTP is used, the user name, password and host
    may be specified as: "user%password@host:" as a prefix to the
    file name