home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / nwclient / !NWClient / !Help < prev    next >
Encoding:
Text File  |  1999-03-02  |  11.7 KB  |  291 lines
  1. This is the latest working version of !NWClient.
  2. ================================================
  3.  
  4. NWClient allows you to access a Novell NetWare (R) fileserver from
  5. RiscOS as the file system NW.  It also provides a file system called
  6. NWPrint, which you can use to print to NetWare printer queues.
  7.  
  8. How to use !NWClient
  9. ====================
  10.  
  11. Normally, double-clicking the !NWClient icon (or running it in your
  12. startup) should be enough to get you going.  !NWClient will try to
  13. attach to the nearest file server, and then run !Login from the login
  14. directory on that server.
  15.  
  16. NWPrint: filesystem for printing to network printers
  17. ----------------------------------------------------
  18. Anything you output to a file called NWPrint: or NWPrint:<options>
  19. will be sent to a print queue on the file server.  The easiest way
  20. to do this is to use !Printers to set the connection of one or more
  21. of your printers to the file "NWPrint:".  If needed, you can specify
  22. options in the filename.  Options may be specified separated with
  23. commas or full stops.
  24. The following options are recognized:
  25.    queue=<printqueuename>     set queue
  26.    banner=<text>              set line 1 of text on banner page
  27.    name=<text>                set line 2 of text on banner page
  28.    form=<text>                set form name (ignored for now)
  29.    server=<servername>        set server name (ignored for now)
  30.    printer=<ndsprintername>   set NDS printer name (ignored for now)
  31.    copies=<integer>           number of copies to make
  32.    tabs=<integer>             tab setting (best to leave at 0)
  33.    lines=<integer>            number of lines on page (used when tabs set)
  34.    columns=<integer>          number of columns on page (used when tabs set)
  35.    ff                         append form feed to job
  36.    noff                       do not append form feed to job
  37.    nobanner                   do not print banner
  38.    notify                     notify after printing page
  39.    nonotify                   do not notify
  40. Example:
  41.    echo hello { > NWPrint:queue=laser,notify }
  42. For the moment, there is no way to change the default options.  I'll
  43. put that in later.
  44.  
  45. !NWClient provides the following commands that can be issued from the
  46. commandline or obey files:
  47.  
  48.    *NW
  49.    ---
  50.    This makes the NWClient file system current.
  51.  
  52.  
  53.    *NW:Attach [-tree <treename>] [-server <servernamename>]
  54.    --------------------------------------------------------
  55.    This command attaches you to a file server, specified by name using
  56.    -server, or by the NDS tree it belongs to using -tree.  Normally
  57.    you don't need to use this command, as you would be connected to
  58.    your nearest server when you run the !NWClient application.
  59.  
  60.  
  61.    *NW:Detach
  62.    ----------
  63.    This command detaches you from whatever file server you are
  64.    attached to.
  65.  
  66.  
  67.    *NW:Login [-user] <username> [-password] <password>
  68.    ---------------------------------------------------
  69.    This command logs you in into the bindery (for 3.x servers) or the
  70.    NDS tree (for newer servers).  You only have to log in once to be
  71.    able to connect to any of the resources on the server.  Currently,
  72.    !NWClient does not support the full NDS, so mounting volumes on
  73.    servers other than the one you've attached to does not work.
  74.    
  75.  
  76.    *NW:Logout
  77.    ----------
  78.    This command logs you out from the server or NDS tree.  You remain
  79.    attached to the server you were attached to.
  80.  
  81.  
  82.    *NW:Mount [[-local] <localname> [-remote] <remotename> [-0] [-1] [-nolongnames|-nl]
  83.    -----------------------------------------------------------------------------------
  84.    This command makes a volume or a directory on a volume available for use
  85.    under RiscOS as a disc on the NW: file system.  The remote name is the
  86.    path (including volume name) of the directory you want to mount, and
  87.    has to be in the format <volume>:<directory>[/<directory>...].  The
  88.    flags -0 and -1 are user-definable flags, of which -0 is used in the
  89.    standard front-end to make the mount invisible, i.e. no icon on the
  90.    iconbar.  The -nl or -nolongnames flag forces !NWClient not to use
  91.    long file names on this mount, but instead to fall back on DOS-style
  92.    filenames.
  93.    When not given any parameters, the mount command displays a list of the
  94.    current mounts, including the internal flags and mount count (in hex).
  95.  
  96.  
  97.    *NW:Dismount [-local=-disc] <localname>
  98.    ---------------------------------------
  99.    This command dismounts the file server directory from the local disc name.
  100.    If the local disc had been mounted more than once, then you need the
  101.    same number of dismounts before the mount actually disappears.  This
  102.    facilitates the use of Mount and Dismount in obey files.
  103.  
  104.  
  105.    *NW:Whoami
  106.    ----------
  107.    Displays some information about your connection to the file server.
  108.  
  109.  
  110.    *NW:Setpass
  111.    -----------
  112.    Does not work yet...
  113.  
  114.  
  115.    *NW:Extensions [file]
  116.    ---------------------
  117.    Set, clear or display list of extensions that are automatically converted
  118.    to RiscOS file types.  The command displays the current list of extensions
  119.    when no parameter is given, and otherwise takes a filename of the same
  120.    format with entries containing file type number, file type description
  121.    and one or more extensions that map onto this file type.
  122.    The command takes two file names as special: 'none' clears the extension
  123.    mapping table (no mapping, identical to !NWClient versions before 1.52)
  124.    and 'default' reverts to the built-in table.
  125.    
  126.  
  127. Installation notes
  128. ==================
  129.  
  130. For everything to work, there *must* be a !Login application
  131. in SYS:LOGIN, this contains the front-end program that provides
  132. the icons on the iconbar.
  133.  
  134.    Prepare the file server
  135.    -----------------------
  136.    Make sure you have the OS2 or LONG name spaces loaded on your file
  137.    server.  If you haven't, type the following commands on the file
  138.    server console:
  139.  
  140.       LOAD LONG.NAM
  141.       ADD NAME SPACE LONG TO SYS
  142.  
  143.    If you have an older server, then the LONG name space is known as
  144.    OS2 name space, and the commands to execute become
  145.  
  146.       LOAD OS2.NAM
  147.       ADD NAME SPACE OS2 TO SYS
  148.  
  149.    You may want to add the name space to any other volumes you have as
  150.    well.
  151.    
  152.    Note: You can run !NWClient without having the LONG name space
  153.    loaded, but that way you will not be able to change file types
  154.    on the file server.  In that case all files will come out as text
  155.    files (type FFF), except when they have the Shared flag set in
  156.    combination with either Hidden or System.  Those flags are used
  157.    in our Linux client for soft links and executable files, and they
  158.    come out with a type to match.
  159.  
  160.    Install RiscOS client
  161.    ---------------------
  162.    Copy the !Login and !NWClient applications onto a directory on your
  163.    RiscOS machine, and then run !NWClient.  It will try to attach to
  164.    whatever NetWare server answers first, and then allow you to login.
  165.    Login as Admin or as any other user with RWCEMF rights to the
  166.    SYS:LOGIN directory on the file server.
  167.    
  168.    Copy software to the file server
  169.    --------------------------------
  170.    At this point you'll probably have the SYS volume mounted on your
  171.    RiscOS machine.  If not, try mounting it manually, by typing
  172.  
  173.       nw:mount SYS SYS:
  174.  
  175.    Copy !Boot, !Apps, !Login and !NWClient onto the LOGIN directory on
  176.    your file server's disc.  Note that !NWClient may actually be stored
  177.    as !NWClien.%t on the file server if you haven't added long name
  178.    space to the SYS volume.
  179.  
  180.  
  181.    Finish
  182.    ------
  183.    Make sure you edit the !Boot file on the file server to do some
  184.    mounts that are sensible in your environment.  Try if everything
  185.    works by restarting your machine, running !NWClient and logging
  186.    in as a regular user, and when it does, delete the !Login directory
  187.    from your RiscOS machine.
  188.    For all other machines on your network you only need to copy
  189.    the !NWClient directory onto their disc.  If you want, you can
  190.    use ShareFS to re-export the login directory on the file server
  191.    (use the -readonly flag!) so that users can grab !NWClient using
  192.    ShareFS.
  193.    
  194.    For ease of use you'll probably want to run !NWClient in your boot
  195.    sequence.  If you want to run any software that needs the file
  196.    server then the best place to run that is in your home directory's
  197.    !Boot file.  See the !Boot file from the distribution for an example,
  198.    including using <NW$User> in the mount command.
  199.    If you set NW$User before you run !NWClient, then it will fill in
  200.    the user name automatically when you log in.
  201.    
  202.  
  203. Copyright
  204. =========
  205.    !NWClient is Copyright 1998-1999 by Frank A. Vorstenbosch 
  206.    (frank@falstaff.demon.co.uk) but can be redistributed freely.
  207.    This work has been very kindly supported by my employer Eidos
  208.    Technologies Ltd. (www.eidos.com), where we are using it all the
  209.    time.  At some point I may make the source available under GPL.
  210.    Check http://www.falstaff.demon.co.uk/nwclient.html for frequent
  211.    updates.
  212.    For questions or bug reports, email nwclient@falstaff.demon.co.uk.
  213.  
  214.  
  215. Changes list
  216. ============
  217.  
  218. Known problems in NWClient
  219. --------------------------
  220.  - !Optimizer crashes when you drag a media file to a NetWare directory.
  221.  - SparkFS doesn't work on the NW: file system (similar problem?).
  222.  
  223. Changes for [1.52]
  224. ------------------
  225.  - Now (slightly) optimizes access to extensions lookup table.
  226.  - Removes duplicates in extensions lookup table.
  227.  - Now sets File$Type_XXX variables with description if not set already.
  228.  - Added NWClient$Version variable which contains the version*100.
  229.  
  230. Changes for [1.51]
  231. ------------------
  232.  - Implemented NW:Extensions command to set and read the list of
  233.    extensions that are translated automatically into RiscOS file types.
  234.  
  235. Changes for [1.50]
  236. ------------------
  237.  - Implemented NW:Whoami command.
  238.  - Added feature to NW:Mount to display mount list if no parameters are
  239.    given.
  240.  - Minor tidying up of code, much improved !Help files.
  241.  
  242. Changes for [1.47]
  243. ------------------
  244.  - Fixed problem with deleting locked files, now returns correct error.
  245.  - Added FreeSpace64 entry point.
  246.  - Now stores all 8 bytes of load/execute address if needed.
  247.  - Now does not use extended attributes to store file types SoftLink
  248.    (0xfdc) and UnixExec (0xfe6), but uses flags instead (like Linux).
  249.  
  250. Changes for [1.45]
  251. ------------------
  252.  - Now finally supports long file names; although short file names
  253.    can still be used (either by choice, or automatically on volumes
  254.    that don't have long name space loaded).  You can use
  255.       nw:mount localname remotename -nolongnames  (or -nl)
  256.    to mount a volume that has long file name space loaded without
  257.    the file name support.
  258.  
  259. Changes for [1.44]
  260. ------------------
  261.  - Now can modify read-only and delete/rename-inhibit flags.
  262.  - Added "NWClient_NCP" swi for access to NCP from user land (e.g.
  263.    debugging or hacking)
  264.  
  265. Changes for [1.43]
  266. ------------------
  267.  - Now checks for existence of NWClient$Stream variable on startup.
  268.    When this variable does not exist, NWClient will not stream on
  269.    long file reads and writes, and will be about 50% slower.  This is
  270.    the only way to get an EtherM to work.
  271.  - Made message from file server saying that it's shut down transient
  272.    like all others, no longer keeps machine busy waiting in SVC mode.
  273.  - Checked NWClient against use on an ARM710 RiscPC (works, but slow).
  274.  
  275. Changes for [1.42]
  276. ------------------
  277.  - Improved speed of file access, now can reach read speeds of 900KB/s
  278.    and write speeds of 975KB/s (measured using Power-tec !Speed).
  279.  - Fixed setting of date/time during login, now works even if Sys$Date
  280.    is set (uses Territory_ConvertStandardDate and ~Time).
  281.  - NWClient now logs console broadcast messages to the file NWMessages
  282.    in <Wimp$ScrapDir>.
  283.  - Added code in front end to check for the connection being broken
  284.    due to the file server being shut down.
  285.  - Improved calculations of free space so that it no longer causes
  286.    so many carry overflows (the new code breaks at the 2TB mark).
  287.  
  288. Changes for [1.38]
  289. ------------------
  290.  - Added date stamp handling
  291.