Changeset 34173 in project


Ignore:
Timestamp:
06/06/17 22:06:58 (6 months ago)
Author:
sjamaan
Message:

man/5: Document new set-file-permissions! and set-file-{owner,group}! procedures

Location:
wiki/man/5
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • wiki/man/5/Module (chicken file posix)

    r34172 r34173  
    355355<procedure>(file-owner FILE)</procedure>
    356356
    357 Returns the user-id of {{FILE}}.  {{FILE}} may be a filename, a file-descriptor
    358 or a port object.
     357Returns the user-id of {{FILE}} (an exact integer).  {{FILE}} may be a
     358filename, a file-descriptor or a port object.
     359
     360==== set-file-owner!
     361
     362<procedure>(set-file-owner! FILE UID)</procedure>
     363<procedure>(set! (file-owner FILE) UID)</procedure>
     364
     365Changes the ownership of {{FILE}} to user-id {{UID}} (which should be
     366an exact integer) using the {{chown()}} system call.  {{FILE}} may be
     367a filename, a file-descriptor or a port object.
     368
     369'''NOTE''': On native Windows builds (all except cygwin), this
     370procedure is unimplemented and will raise an error.
     371
     372==== file-group
     373
     374<procedure>(file-group FILE)</procedure>
     375
     376Returns the group-id of {{FILE}}.  {{FILE}} may be a filename, a
     377file-descriptor or a port object.
     378
     379==== set-file-group!
     380
     381<procedure>(set-file-group! FILE GID)</procedure>
     382<procedure>(set! (file-group FILE) GID)</procedure>
     383
     384Changes the group ownership of {{FILE}} to group-id {{GID}} (which
     385should be an exact integer) using the {{chgrp()}} system call.
     386{{FILE}} may be a filename, a file-descriptor or a port object.
     387
     388'''NOTE''': On native Windows builds (all except cygwin), this
     389procedure is unimplemented and will raise an error.
    359390
    360391
     
    367398values.  {{FILE}} may be a filename, a file-descriptor or a port object.
    368399
    369 === Changing file attributes
     400==== set-file-permissions!
     401
     402<procedure>(set-file-permissions! FILE MODE)</procedure>
     403<procedure>(set! (file-permissions FILE) MODE)</procedure>
     404
     405Changes the current permission bits for {{FILE}} to {{MODE}} using the
     406{{chmod()}} system call.  The {{perm/...}} variables contain the
     407various permission bits and can be combinded with the {{bitwise-ior}}
     408procedure.  {{FILE}} may be a filename, a file-descriptor or a port
     409object, {{MODE}} should be a fixnum.
     410
    370411
    371412==== file-truncate
  • wiki/man/5/Module (chicken file)

    r34094 r34173  
    125125temporary directory is created at that location.
    126126
    127 === Changing file attributes
    128 
    129 ==== change-file-mode
    130 
    131 <procedure>(change-file-mode FILENAME MODE)</procedure>
    132 
    133 Changes the current file mode of the file named {{FILENAME}}
    134 to {{MODE}} using the {{chmod()}} system call.  The
    135 {{perm/...}} variables contain the various permission bits and can
    136 be combinded with the {{bitwise-ior}} procedure.
    137 
    138 ==== change-file-owner
    139 
    140 <procedure>(change-file-owner FILENAME UID GID)</procedure>
    141 
    142 Changes the owner information of the file named {{FILENAME}} to
    143 the user- and group-ids {{UID}} and {{GID}} (which should be
    144 exact integers) using the {{chown()}} system call.
    145 
    146 '''NOTE''': On native Windows builds (all except cygwin), this
    147 procedure is unimplemented and will raise an error.
    148 
    149127
    150128=== Information about files
Note: See TracChangeset for help on using the changeset viewer.