• NAME
• SYNTAX
• DESCRIPTION
• OPTIONS
  • -d <debug-level>
  • -h
  • -H <help-option>
  • -i <numerical-IP>
  • -l <login>
  • -n <dns-TCP>
  • -r <runtime states>
  • -R <remote-host>
  • -V
  • -X
• ARGUMENTS
• EXIT-VALUES
• SEE ALSO
• AUTHOR
• COPYRIGHT

.

NAME

ctys-smbutil - displays available SMB server and workstations

SYNTAX

ctys-smbutil

   [-d <debug-level>]
   [-h]
   [-H <help-options>]
   [-i <numerical-IP>]
   [-l <remote-login>]
   [-n <dns-TCP>]
   [-r [(REVERSE|R|-),]PING|SSH[,PM|VM] ]
   [-V]
   [-X]

DESCRIPTION

ctys-smbutil (Address-Resolution) displays a short list of current available SMB server and workstations.

.

OPTIONS

ctys-smbutil

-d <debug-level>

Same as ctys.

-h

Print help, refer to "-H" for additional information.

-H <help-option>

The extended help option is based on system interfaces for display of manpages, PDF and HTML documents. This comprises the man pages and installed manuals.

For additional help refer to the documents or type ctys -H help.

-i <numerical-IP>

Show numerical TCP/IP-Address. This is supported in combination with "-n" option only without "-X" option.

-l <login>

Account for remotecalls.

-n <dns-TCP>

Show TCP/IP-Address as name. This is supported in combination with "-i" option only without "-X" option.

-r <runtime states>

Restricts a set of multiple results with additional constrains for output.

Only the possible targets which are operable or actually operational are listed. This includes the actual running VM with it's hosting PM, and in addition all other operational machines, where the current VM is available too. This case is the most common for NFS based exec-pools, where a single VM could be accessed remotely by a number of PMs. This particularly offers the advantage of copyless-migration of online and offline VMs.

Very handy, and in companion with others probably one of the most important internal top-level-calls for GuestOS-Command-Execution.

  <runtime states>=[(REVERSE|R|-),]PING|SSH[,PM|VM]

• REVERSE|R|- This reverses the resulting set, thus the "not matching" states only will be shown.
  -PING[:<packetcnt>[%<timeout>]] A RUNNING session is simply "ping-ed". Resulting statement of operational mode may result on applied security policies, but not exclusively on the state of the running OS's IP-stack.
  
  

-R <remote-host>

The remote host for the inherent beamer function to place the execution immediately on an arbitrary execution relay.

-V

See ctys, version output.

-X

See ctys, terse for machine output.

.

ARGUMENTS

.

EXIT-VALUES

0: OK:

Result is valid.

1: NOK:

Erroneous parameters.

2: NOK:

Missing an environment element like files or databases.

SEE ALSO

ctys executables

ctys-extractARPlst(1), ctys-extractMAClst(1), ctys-genmconf(1), ctys-vping(1), ctys-plugins(1), ctys-vhost(1)

system executables

dig(1), dmidecode(8), ether-tool(8), host(1), nc(1)<a.k.a. netcat>

AUTHOR

Written and maintained by Arno-Can Uestuensoez:

COPYRIGHT

Copyright (C) 2008, 2009, 2010, 2011 Ingenieurbuero Arno-Can Uestuensoez

For BASE package following licenses apply,

• for software see GPL3 for license conditions,
• for documents see GFDL-1.3 with invariant sections for license conditions,

This document is part of the DOC package,

• for documents and contents from DOC package see
  'Creative-Common-Licence-3.0 - Attrib: Non-Commercial, Non-Deriv'
  
  
  with optional extensions for license conditions.

For additional information refer to enclosed Releasenotes and License files.