1 
   2 #
   3 # This file and its contents are supplied under the terms of the
   4 # Common Development and Distribution License ("CDDL"), version 1.0.
   5 # You may only use this file in accordance with the terms of version
   6 # 1.0 of the CDDL.
   7 #
   8 # A full copy of the text of the CDDL should have accompanied this
   9 # source.  A copy of the CDDL is also available via the Internet at
  10 # http://www.illumos.org/license/CDDL.
  11 #
  12 
  13 #
  14 # Copyright 2017 Nexenta Systems, Inc.  All rights reserved.
  15 #
  16 
  17 This directory builds a program linking all of the SMB client code
  18 into a user-level process.  The result is not a fully functional
  19 SMB client but is very useful for some kinds of development work.
  20 
  21 The architecture of this roughly parallels the in-kernel version,
  22 where the kernel modules are build as libraries including:
  23   libfksmbfs, libfknsmb
  24 
  25 Just as with the kernel code, there are mdb modules that know
  26 how to walk data structures in libfksmbfs, etc.
  27 
  28 For debugging, etc. it's easiest to run this as a normal user,
  29 i.e. yourself (not root)
  30 
  31 Now you can run fksmbcl from the proto area using this script:
  32   ./Run.sh -df
  33 
  34 You can also run it under dbx (see the .dbxrc file).
  35 To run it under mdb (with mdb modules build here):
  36   mdb -L $ROOT/usr/lib/mdb/proc:/usr/lib/mdb/proc ...
  37 where ... is one of: fksmbcl, core.nnn, -p $PID
  38 
  39 There are also some dtrace scripts in here, and in ../dtrace
  40 for watching either all activity or only selected areas.
  41 Run these like:  dtrace -s Watch-all.d -p $PID -o output
  42 
  43 These two (from over in ../dtrace) also work with fksmbcl:
  44         dtrace -s fksmbcl.d -p `pgrep fksmbcl`  -o output
  45 
  46 Here are a couple simple, handy tests you can try:
  47 
  48 [todo]