Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FSPD(1)			    General Commands Manual		       FSPD(1)

NAME
       fspd, in.fspd - File Service Protocol (FSP) server

SYNOPSIS
       fspd  [-f  configfile] [-p port]	[-i] [-v|-V] [-t timeout] [-X] [-d di-
       rectory]	[-F ] [-T temporary directory] [-l  logfile]  [-P  pidlogname]
       [-b bandwidth] [-s packetsize]

DESCRIPTION
       fspd  is	 the server for	an anonymous-ftp style archive called FSP. The
       main features of	this service are: connection-less model, communication
       robustness,  server  resource  protection, inter-client protection, and
       user friendly interface.	Please read the	INFO file bundled with the FSP
       source for more information.

OPTIONS
       -f		   May	be  used to specify an alternate configuration
			   file.

       -i		   Use when fspd is running from inetd.

       -p port		   May be used to specify an alternative port.

       -d directory	   May be used to specify an alternative  home	direc-
			   tory.

       -v | -V		   Show	server version.

       -X		   Turn	on debuging.

       -t timeout	   Set	server inactivity shutdown timeout for running
			   in inetd mode. Default is 120 seconds. When	-d  is
			   used,  this timeout works in	normal mode also (use-
			   full	for debuging of	memory leaks).

       -F		   Run fspd in foreground, do not daemonize.

       -T directory	   Set server temporary	directory used for  uploading.
			   This	 directory  can	 be outside FSP	home directory
			   since it is not directly accessible by clients. Us-
			   ing	directory  inside  FSP	home is	not a security
			   risk.

       -l logfile	   Write log output to file.

       -P pidlogname	   Write pid to	the given file name.

       -b bandwidth	   Enable bandwidth limiting. Limit  output  to	 band-
			   width bytes per second.

       -s packetsize	   Sets	 maximum  allowed or prefered packet's payload
			   size. Server	must support packets up	to  1024,  but
			   may	prefer to send smaller packets.	 It may	accept
			   packets over	1024  bytes.  Default  value  is  1460
			   bytes.   All	 networks must be able to transfer 500
			   bytes (RFC requirement).

FILES
       .FSP_OWNER	   Used	to indicate  the  ownership  of	 a  directory.
			   This	 file  contains	 lines with the	same syntax as
			   host	lines in fspd.cnf but without keyword host  on
			   start  of  line.  Host types	D, I, N	can be used to
			   restrict access to specific directory.  Owners  are
			   marked with host type O.

       .README		   A text file that is sent to the client when the di-
			   rectory is entered giving information about the di-
			   rectory.   It  can only be hand created by the site
			   administrator at this time. This text  file	should
			   be  no more than 1022 bytes in size.	Any data above
			   this	limit will be silently ignored.	Name  of  this
			   file	can be changed in server configuration file.

       .FSP_OK_DEL	   Existence  of  this file in a directory grants non-
			   owner machines the permission to delete items  from
			   this	directory.

       .FSP_OK_ADD	   Existence  of  this file in a directory grants non-
			   owner machines the permission to add	items to  this
			   directory.

       .FSP_NO_LIST	   Existence  of this file removes right to list a di-
			   rectory from	non-owner.

       .FSP_NO_GET	   Existence of	this file in a	directory  means  that
			   files  in  that directory cannot be read by public,
			   i.e.	they are private.

       .FSP_OK_MKDIR	   Existence of	this file in a directory  grants  non-
			   owner machines the permission to create subdirecto-
			   ries	under the current directory.

       .FSP_OK_RENAME	   Existence of	this file in a directory  grants  non-
			   owner  machines  the	 permission to rename files in
			   directory.

       .FSP_OK_PASSWORD	   Password required for non privileged	access.

       .FSP_OWNER_PASSWORD Password required for privileged access.  You  must
			   have	also your IP listed in .FSP_OWNER file.

       .TXXXXXXXXXXXX	   Transient  temporary	 file in the FSP temporary di-
			   rectory used	for file uploading.

       .GXXXXXXXXXXXX	   Transient temporary file in the FSP	temporary  di-
			   rectory used	for file downloading through the fgrab
			   command.

       fspd.conf	   A file containing  control  information  about  how
			   specific features of	the server are to be used. See
			   the example.conf file for explicit details.

       .FSP_CONTENT	   File	used to	cache directory	listing.   Such	 files
			   are	normally  created  on demand in	each directory
			   that	fspd exports.

SIGNALS
       SIGUSR1
	      Server dumps stats to file specified as dumpfile	in  configura-
	      tion.  This file must be writeable by server or server must have
	      rights to	create it.

       SIGINT |	SIGTERM
	      Server performs cleaup and exits.	All connected clients will  be
	      disconnected.  Because  FSP  is stateless	protocol, if you start
	      server later, clients can	continue without breakage.

EXIT CODES
       1 configuration or command line invocation error.

       2 can not open/bind server socket

       3 can not change	uid to runuid

       4 can not change	gid to rungid

       5 out of	memory

       6 can not change	directory to homedir

       7 select() error

       8 can not write pidfile

       99 Internal terror

CLIENTS
       You need	FSP version 2 compatible client	to be  able  to	 talk  to  the
       server.	Most  popular  is  fspclient(1)	 which	can be downloaded from
       http://fspclient.sourceforge.net. Other possibility is to use  commands
       from fsp	distribution listed in SEE ALSO	section.

SEE ALSO
       fcatcmd(1),  fcdcmd(1),	fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1),
       fprocmd(1),  fput(1),  frmcmd(1),  frmdircmd(1),	 fver(1),   fducmd(1),
       fhostcmd(1),  fspd(1),  fsp_prof(5),  ffindcmd(1),  fbye(1), fmvcmd(1),
       fspscan(1), fspclient(1)

FSP				   Aug 2019			       FSPD(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SIGNALS | EXIT CODES | CLIENTS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fspd&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help