DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Deposit(4)




Deposit(4)	 DEVICES AND NETWORK INTERFACES	       Deposit(4)

NAME
     Deposit request - save a document to its backing store

SYNOPSIS
     [file] Deposit(in mediaType contents
		    [in	messageID commission]);

DESCRIPTION
     The Deposit request saves a document to its  backing  store.
     This  request is different	from the Save request in that the
     requester (not the	handler) has the data to be saved.

     The contents argument is the contents of the  document.   If
     this  argument  is	 unset	(in  other  words, has a value of
     (char *)0), then the contents of the  document  are  in  the
     file  named  in the message's file	attribute.  The	data type
     (mediaType) of  the  contents  argument  should  be  string,
     unless  nulls  are	 valid	in the given media type, in which
     case the data type	must be	bytes.

     The commission argument contains the message ID of	the  Edit
     request that caused the creation of this buffer.

APPLICATION USAGE
     The ttmedia_load(3) function can be used  to  register  for,
     and help process, this message.

     This message can be sent with the	ttmedia_Deposit(3)  func-
     tion.

     The Deposit request is useful for cases where the	user  may
     perform  an intermediate save of modifications to a document
     that is the subject of an Edit or Display	request	 in  pro-
     gress.   In  the  latter  case,  the  Deposit  may	fail on	a
     TT_DESKTOP_EACCES	error  if  the	handler	 does  not  allow
     updates to	the document being displayed.

     Handlers receiving	this request should reply before deleting
     any  file named in	the message's file attribute, but this is
     optional and applications should not rely on this.

ERRORS
     The ToolTalk service may return one of the	following  errors
     in	processing the Deposit request:

	TT_DESKTOP_EACCES
	      The document is read-only.

	TT_DESKTOP_ENOENT
	      The file that was	alleged	to contain  the	 document
	      does not exist.

Unix System LaboratorLast change: 13 May 1994			1

Deposit(4)	 DEVICES AND NETWORK INTERFACES	       Deposit(4)

	TT_DESKTOP_ENODATA
	      The in-mode contents argument had	no value and  the
	      file attribute of	the message was	not set.

	TT_MEDIA_ERR_FORMAT
	      The document is not a valid instance of  the  media
	      type.

SEE ALSO
     ttmedia_load(3), ttmedia_Deposit(3); Intro, Display, Edit,
     Status requests.

Unix System LaboratorLast change: 13 May 1994			2


Man(1) output converted with man2html