rom/dos/setcomment.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Set a filecomment.
   6     Lang: english
   7 */
   8 #include <proto/exec.h>
   9 #include <dos/dosextens.h>
  10 #include <dos/filesystem.h>
  11 #include <proto/dos.h>
  12 #include "dos_intern.h"
  13
  14 /*****************************************************************************
  15
  16     NAME */
  17 #include <proto/dos.h>
  18
  19         AROS_LH2(BOOL, SetComment,
  20
  21 /*  SYNOPSIS */
  22         AROS_LHA(STRPTR, name,    D1),
  23         AROS_LHA(STRPTR, comment, D2),
  24
  25 /*  LOCATION */
  26         struct DosLibrary *, DOSBase, 30, Dos)
  27
  28 /*  FUNCTION
  29         Change the comment on a file or directory.
  30         The comment may be any NUL terminated string. The supported
  31         size varies from filesystem to filesystem.
  32
  33     INPUTS
  34         name    - name of the file
  35         comment - new comment for the file or NULL.
  36
  37     RESULT
  38         !=0 if all went well, 0 else. IoErr() gives additional
  39         information in that case.
  40
  41     NOTES
  42
  43     EXAMPLE
  44
  45     BUGS
  46
  47     SEE ALSO
  48
  49     INTERNALS
  50
  51 *****************************************************************************/
  52 {
  53     AROS_LIBFUNC_INIT
  54     AROS_LIBBASE_EXT_DECL(struct DosLibrary *,DOSBase)
  55
  56     /* Get pointer to I/O request. Use stackspace for now. */
  57     struct IOFileSys iofs;
  58
  59     /* Prepare I/O request. */
  60     InitIOFS(&iofs, FSA_SET_COMMENT, DOSBase);
  61
  62     if(comment == NULL)
  63         comment = "";
  64     iofs.io_Union.io_SET_COMMENT.io_Comment = comment;
  65
  66     return !DoName(&iofs, name, DOSBase);
  67
  68     AROS_LIBFUNC_EXIT
  69 } /* SetComment */