macfile
Updated: January 21, 2005
Use the macfile commands at the command prompt to manage File Server for Macintosh servers, volumes, directories, and files. You can automate administrative tasks by including a series of commands in batch files and starting them manually or at predetermined times.
- To modify directories in Macintosh-accessible volumes
- To join a Macintosh file's data and resource forks
- To change the logon message and limit sessions
- To add, change, or remove Macintosh-accessible volumes
To modify directories in Macintosh-accessible volumes
Syntax
macfile directory[/server:\\ComputerName]
/path:Directory [/owner:OwnerName][/group:GroupName][/permissions:Permissions]
Parameters
/server:\\ComputerName
Specifies the server on which to change a directory.
If omitted, the operation is performed on the local
computer.
/path:Directory
Required. Specifies the path to the directory that
you want to change. The directory must exist.
Macfile directory does not create directories.
/owner:OwnerName
Changes the owner of the directory. If omitted, the
owner remains unchanged.
/group:GroupName
Specifies or changes the Macintosh primary group
that is associated with the directory. If omitted,
the primary group remains unchanged.
/permissions:Permissions
Sets permissions on the directory for the owner,
primary group, and world (everyone). An 11-digit
number is used to set permissions. The number 1
grants permission and 0 revokes permission (for
example, 11111011000). The position of the digit
determines which permission is set, as described in
the following table. If omitted, permissions remain
unchanged.PositionSets Permission forFirstOwnerSeeFilesSecond OwnerSeeFoldersThirdOwnerMakeChanges
FourthGroupSeeFilesFifthGroup SeeFoldersSixthGroupMakeChanges
SeventhWorldSeeFilesEighthWorldSeeFoldersNinthWorldMake
ChangesTenthThe directory cannot be renamed, moved,
or deleted.EleventhThe changes apply to the current
directory and all subdirectories.
/?
Displays help at the command prompt.
Remarks
| • | If the information that you supply contains spaces or special characters, use quotation marks around the text (for example, "Computer Name"). |
| • | Use macfiledirectory to make an existing directory in a Macintosh-accessible volume available to Macintosh users. The macfiledirectory command does not create directories. Use File Manager, the command prompt, or the macintosh new folder command to create a directory in a Macintosh-accessible volume before you use the macfile directory command. |
Examples
The following example changes the permissions of the
subdirectory May sales, in the Macintosh-accessible volume
Statistics, on the E drive of the local server. The example
assigns See Files, See Folders, and Make Changes permissions to
the owner and See Files and See Folders permissions to all other
users, while preventing the directory from being renamed, moved,
or deleted.
macfile directory /path:"e:\statistics\may sales" /permissions:11111011000
To join a Macintosh file's data and resource forks
Syntax
macfile forkize[/server:\\ComputerName][/creator:CreatorName][/type:TypeName][/datafork:FilePath][/resourcefork:FilePath]
/targetfile:FilePath
Parameters
/server:\\ComputerName
Specifies the server on which to join files. If
omitted, the operation is performed on the local
computer.
/creator:CreatorName
Specifies the creator of the file. The Macintosh
Finder uses the /creator command-line option
to determine the application that created the file.
/type:TypeName
Specifies the type of file. The Macintosh Finder
uses the /type command-line option to
determine the file type within the application that
created the file.
/datafork:FilePath
Specifies the location of the data fork that is to
be joined. You can specify a remote path.
/resourcefork:FilePath
Specifies the location of the resource fork that is
to be joined. You can specify a remote path.
/targetfile:FilePath
Required. Specifies the location of the file that is
created by joining a data fork and a resource fork,
or specifies the location of the file whose type or
creator you are changing. The file must be on the
specified server.
/?
Displays help at the command prompt.
Remarks
- If the information that you supply contains spaces or special characters, use quotation marks around the text (for example, "Computer Name").
Examples
To create the file Treeapp on the Macintosh-accessible volume
D:\Release, using the resource fork C:\Cross\Mac\Appcode, and to
make this new file appear to Macintosh clients as an application
(Macintosh applications use the type APPL) with the creator
(signature) set to MAGNOLIA, type:
macfile forkize /resourcefork:c:\cross\mac\appcode /type:APPL /creator:MAGNOLIA /targetfile:D:\Release\Treeapp
To change the file creator to Microsoft Word 5.1, for the file WORD.txt in the directory D:\Word documents\Group files, on the server \\SERVERA, type:
macfile forkize /server:\\servera /creator:MSWD /type:TEXT /targetfile:"d:\Word documents\Group files\Word.txt"
To change the logon message and limit sessions
Syntax
macfile server [/server:\\ComputerName][/maxsessions:{Number|unlimited}][/loginmessage:Message]
Parameters
/server:\\ComputerName
Specifies the server on which to change parameters.
If omitted, the operation is performed on the local
computer.
/maxsessions:{Number|unlimited}
Specifies the maximum number of users who can
simultaneously use File and Print Servers for
Macintosh. If omitted, the maxsessions
setting for the server remains unchanged.
/loginmessage:Message
Changes the message Macintosh users see when logging
on to the File Server for Macintosh server. The
maximum number of characters for the logon message
is 199. If omitted, the loginmessage message
for the server remains unchanged. To remove an
existing logon message, include the /loginmessage
parameter, but leave the Message variable
blank
/?
Displays help at the command prompt.
Remarks
- If the information that you supply contains spaces or special characters, use quotation marks around the text (for example, "Computer Name").
Examples
To change the number of File and Print Server for Macintosh
sessions that are permitted on the local server from the current
setting to five sessions, and to add the logon message "Log off
from Server for Macintosh when you are finished.", type:
macfile server /maxsessions:5 /loginmessage:"Log off from Server for Macintosh when you are finished."
To add, change, or remove Macintosh-accessible volumes
Syntax
macfile volume {/add|/set}[/server:\\ComputerName]
/name:VolumeName/path:Directory[/readonly:{true
| false}][/guestsallowed:{true |
false}] [/password:Password][/maxusers:{Number|unlimited}]
macfile volume /remove[/server:\\ComputerName] /name:VolumeName
Parameters
{/add|/set}
Required when you are adding or changing a
Macintosh-accesible volume. Adds or changes the
specified volume.
/server:\\ComputerName
Specifies the server on which to add, change, or
remove a volume. If omitted, the operation is
performed on the local computer.
/name:VolumeName
Required. Specifies the volume name to be added,
changed, or removed.
/path:Directory
Required and valid only when you are adding a
volume. Specifies the path to the root directory of
the volume to be added.
/readonly:{true | false}
Specifies whether users can change files in the
volume. Type true to specify that users
cannot change files in the volume. Type false
to specify that users can change files in the
volume. If omitted when adding a volume, changes to
files are allowed. If omitted when changing a
volume, the readonly setting for the volume remains
unchanged.
/guestsallowed:{true | false}
Specifies whether users who log on as guests can use
the volume. Type true to specify that guests
can use the volume. Type false to specify
that guests cannot use the volume. If omitted when
adding a volume, guests can use the volume. If
omitted when changing a volume, the guestsallowed
setting for the volume remains unchanged.
/password:Password
Specifies a password that will be required to access
the volume. If omitted when adding a volume, no
password is created. If omitted when changing a
volume, the password remains unchanged.
/maxusers:{Number|unlimited}
Specifies the maximum number of users who can
simultaneously use the files on the volume. If
omitted when adding a volume, an unlimited number of
users can use the volume. If omitted when changing a
volume, the maxusers value remains unchanged.
/remove
Required when you are removing a Macintosh-accesible
volume. Removes the specified volume.
/?
Displays help at the command prompt.
Remarks
- If the information that you supply contains spaces or special characters, use quotation marks around the text (for example, "Computer Name").
Examples
To create a volume called US Marketing Statistics on the local
server, using the Stats directory in the E drive, and to specify
that the volume cannot be accessed by guests, type:
macfile volume /add /name:"US Marketing Statistics" /guestsallowed:false /path:e:\Stats
To change the volume created above to be read-only and to require a password, and to set the number of maximum users to five, type:
macfile volume /set /name:"US Marketing Statistics" /readonly:true /password:saturn /maxusers:5
To add a volume called Landscape Design, on the server \\Magnolia, using the Trees directory in the E drive, and to specify that the volume can be accessed by guests, type:
macfile volume /add /server:\\Magnolia /name:"Landscape Design" /path:e:\Trees
To remove the volume called Sales Reports on the local server, type:
macfile volume /remove /name:"Sales Reports"
Formatting legend
| Format | Meaning |
| Italic | Information that the user must supply |
| Bold | Elements that the user must type exactly as shown |
| Ellipsis (...) | Parameter that can be repeated several times in a command line |
| Between brackets ([]) | Optional items |
| Between braces ({}); choices separated by pipe (|). Example: {even|odd} | Set of choices from which the user must choose only one |
| Courier font | Code or program output |