Unix/Linux Go Back    


CentOS 7.0 - man page for nfstest.host (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


NFSTEST.HOST(1) 			nfstest.host 1.0.1			  NFSTEST.HOST(1)

NAME
       nfstest.host - Host module

DESCRIPTION
       Provides a set of tools for running commands on the local host or a remote host, including
       a mechanism for running commands in the background.  It provides methods for mounting  and
       unmounting  from an NFS server and a mechanism to simulate a network partition via the use
       of 'iptables'.  Currently, there is no mechanism to restore the iptables  rules	to  their
       original state.

CLASSES
   class Host(baseobj.BaseObj)
       Host object

       Host() -> New Host object

       Usage:
	   from nfstest.host import Host

	   # Create host object for local host
	   x = Host()
	   # Create host object for remote host
	   y = Host(host='192.168.0.11')

	   # Run command to the local host
	   x.run_cmd("ls -l")

	   # Send command to the remote host and run it as root
	   y.run_cmd("ls -l", sudo=True)

	   # Run command in the background
	   x.run_cmd("tcpdump", sudo=True, wait=False)
	   ....
	   ....
	   # Stop command running in the background
	   x.stop_cmd()

	   # Mount volume using default options
	   x.mount()

	   # Unmount volume
	   x.umount()

       Methods defined here:
       ---------------------

       __init__(self, **kwargs)
	      Constructor

	      Initialize object's private data.

	      host:  Hostname or IP address [default: localhost]

	      user:  User to log in to host [default: '']

	      server:
		     NFS server name or IP address [default: None]

	      nfsversion:
		     NFS version [default: 4]

	      minorversion:
		     NFS minor version [default: 1]

	      port:  NFS server port [default: 2049]

	      export:
		     Exported file system to mount [default: '/']

	      mtpoint:
		     Mount point [default: '/mnt/t']

	      datadir:
		     Data directory where files are created [default: '']

	      mtopts:
		     Mount options [default: 'hard,rsize=4096,wsize=4096']

	      interface:
		     Network device interface [default: 'eth0']

	      nomount:
		     Debug option so the server is not actually mounted [default: False]

	      iptables:
		     Iptables command [default: '/usr/sbin/iptables']

	      sudo:  Sudo command [default: '/usr/bin/sudo']

       mount(self, **kwargs)
	      Mount the file system on the given mount point.

	      server:
		     NFS server name or IP address [default: self.server]

	      nfsversion:
		     NFS version [default: self.nfsversion]

	      minorversion:
		     NFS minor version [default: self.minorversion]

	      port:  NFS server port [default: self.port]

	      export:
		     Exported file system to mount [default: self.export]

	      mtpoint:
		     Mount point [default: self.mtpoint]

	      datadir:
		     Data directory where files are created [default: self.datadir]

	      mtopts:
		     Mount options [default: self.mtopts]

	      Return the mount point.

       network_drop(self, ipaddr, port)
	      Simulate	a  network drop by dropping all tcp packets going to the given ipaddr and
	      port using the iptables commands.

       network_reset(self)
	      Reset the network by flushing all the chains in the table using the  iptables  com-
	      mand.

       run_cmd(self, cmd, sudo=False, dlevel='DBG1', msg='', wait=True)
	      Run  the command to the remote machine using ssh.  There is no user authentication,
	      so remote host must allow ssh connection without any passwords for the user.  For a
	      localhost the command is just executed and ssh is not used.

	      The  object  for	the  process  of  the  command	is  stored  in	object	attribute
	      'self.process' to be used by methods wait_cmd() and stop_cmd(). The standard output
	      of  the  command	is  also  stored in the object attribute 'self.pstdout' while the
	      standard error output of the command is stored in 'self.pstderr'.

	      cmd:   Command to execute

	      sudo:  Run command using sudo if option is True

	      dlevel:
		     Debug level for displaying the command to the user

	      msg:   Prefix this message to the debug message to be displayed

	      wait:  Wait for command to complete before returning

	      Return the standard output of the command and the return code  or  exit  status  is
	      stored in the object attribute 'self.returncode'.

       stop_cmd(self, process=None, dlevel=None, msg='')
	      Terminate  command  started by run_cmd() by calling wait_cmd() with the 'terminate'
	      option set to True.

	      process:
		     The object for the process of the command to  terminate,  or  terminate  all
		     commands started by run_cmd() if this option is not given

	      dlevel:
		     Debug  level  for	displaying  the command to the user, default is the level
		     given by run_cmd()

	      msg:   Prefix this message to the debug message to be displayed

	      Return the exit status of the last command

       sudo_cmd(self, cmd)
	      Prefix the SUDO command if effective user is not root.

       umount(self)
	      Unmount the file system.

       wait_cmd(self, process=None, terminate=False, dlevel=None, msg='')
	      Wait for command started by run_cmd() to finish.

	      process:
		     The object for the process of the command to wait for, or wait for all  com-
		     mands started by run_cmd() if this option is not given

	      terminate:
		     If  True,	send  a signal to terminate the command or commands and then wait
		     for all commands to finish

	      dlevel:
		     Debug level for displaying the command to the user,  default  is  the  level
		     given by run_cmd()

	      msg:   Prefix this message to the debug message to be displayed

	      Return the exit status of the last command

       Static methods defined here:
       ----------------------------

       get_ip_address(host='', ipv6=False)
	      Get  IP  address	associated  with  the  given  host name.  This could be run as an
	      instance or class method.

SEE ALSO
       baseobj(1)

BUGS
       No known bugs.

AUTHOR
       Jorge Mora (mora@netapp.com)

NFStest 1.0.2				  10 April 2013 			  NFSTEST.HOST(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:59 AM.