aquarela man page on Plan9

Man page or keyword search:  
man Server   549 pages
apropos Keyword Search (all sections)
Output format
Plan9 logo
[printable version]

AQUARELA(8)							   AQUARELA(8)

       aquarela - CIFS server

       aquarela [ -np ] [ -d debug ] [ -u N ] [ -w workgroup ]

       Aquarela	 provides  CIFS	 (once	known  as  SMB)	 access to Plan 9 file
       servers.	 It announces and subsequently listens on tcp!*!445  for  con‐
       nections	 to  the  file	hierarchies  called  `shares' by CIFSUsers are
       authenticated with their APOP secret (see auth(8)).   Each  session  is
       managed by a process running as the authenticated user.	Two persistent
       processes handle listening, session setup, and housekeeping.

       An aquarela CIFS share corresponds to a directory under /n.   A	client
       request	for a specific share, say, share, causes aquarela to attempt a
       9fs (in srv(4)) connection to the file  server  share.	If  connection
       succeeds,  a  file  hierarchy  rooted  at  /n/share is presented to the
       client.	The client request fails otherwise.  Requests for the protocol
       equivalent  of  /  are  satisfied  with a directory containing only the
       default share, local.

       The options are:

       -n     Enable limited NETBIOS service.  Aquarela will register with the
	      `master  browser'	 for  workgroup	 and  listen  on tcp!*!139 and
	      udp!*!13[7-9] for NETBIOS name resolution and session  requests.
	      This works in tandem with a complete NETBIOS master name server,
	      like that provided by Unix nmbd(8).  NETBIOS is not required for
	      CIFS file service.

       -u N   Send  Unicode.   For  N, 1 enables, 0 disables Unicoding of file
	      names and metadata.  There is no code page support, so  aquarela
	      emits UTF if N is 0.

       -w workgroup
	      Set workgroup (or `primary domain') of server.  Default PLAN9.

       To start CIFS service on system plan9:

	      % aquarela -u 1 &

       To  then	 make  the  dump filesystem available as drive Y: on a Windows

	      C:\>net use Y: \\\dump

	      Default CIFS share

	      Log file


       auth(8), srv(4), utf(6)

       Log messages are appended to /sys/log/aquarela if  it  exists.  The  -p
       option prints them on standard output as well.  The -d option adds ver‐
       bose output about debug to the log messages, where debug is one of:

	      All CIFS requests and responses.

       tids   Connections and disconnections per-share.

       sids   Creation and deletion of search ids.

       fids   Creation and deletion of file ids.

       rap2   RAP calls.

       find   Transaction2 find commands.

       query  Transaction2 query commands.

	      All files opened.

	      Draconian error checking in memory allocator.

	      Connections and disconnections on server.

       rep    Regular expression conversions.

       locks  Locking activity.

	      Debug only SMB_ requests	or  transaction2  sub-requests	(e.g.,
	      symbolic name any-smb-name.

       0xnn   Debug only messages with hexadecimal id 0xnn.

       The first connection attempt to a share sometimes fails	erroneously  -
       try  again.   The  share disk space reported by some clients is inaccu‐
       rate.  Some clients can't rename directories.  Write  attempts  without
       sufficient permissions fail (correctly), but appear on client to tempo‐
       rarily succeed.

       This program should probably be named cifsserver.

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Plan9

List of man pages available for Plan9

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net