filemgr(1)
NAME
filemgr − a window-based program to manage UNIX files
SYNOPSIS
filemgr [ −d directory ] [ −i secs ] [ −a ] [ −name app-name ] [ −r ] [ −c ] [ −D ] [ −v ] [ −? ]
DESCRIPTION
filemgr is a graphical UNIX file management program. It allows you to navigate through and manipulate files. You can find, copy, move, link, open, and print existing or new files. You can find files, change file properties, and view multiple directories at the same time.
OPTIONS
filemgr accepts all the generic tool arguments described in shelltool(1). In addition, it can accept these options:
−d directory
This will start filemgr in the given directory .
−i secs
This will set the timer to check on folder and/or file modification times every secs seconds.
−a This will force filemgr to check both folder and file modification times. By default, filemgr only checks the folder modification times. Be careful, as this option will severely affect performance.
−name app-name
This option specifies the application name under which resources are to be obtained, rather than the default executable file name. app-name should not contain “.” or “∗” characters.
−r This will force filemgr to display file pane items by rows, rather than by columns (default).
−c This will force filemgr to display file pane items by columns, rather than by rows.
−v This will display the current version number of filemgr.
−? This will display a partial list of command line options which can be passed to filemgr. For additional generic options which can be passed to filemgr, type "man shelltool -?".
RESOURCES
On startup, the filemgr will use the following X resources which are stored in $HOME/.desksetdefaults. Note these resource names will be prepended with deskset.filemgr.
Resource: applicationColor
Values: Color name string or hexadecimal color specification string
Description The color of the default application icon.
Resource: confirmDelete
Values: True, False (True)
Description When true, sends deleted files to the wastebasket. Otherwise, files are deleted normally as if you had run a rm command.
Resource: documentColor
Values: Color name string or hexadecimal color specification string
Description The color of the default application icon.
Resource: filenameWidth
Values: 0-255 (255)
Description The maximum number of characters to display in a filename. Note this is based on the average width of characters, so when using proportional fonts the number of characters displayed will vary.
Resource: filterScript
Values: regular expression (NULL)
Description A regular expression describing which files you wish to view. The default is empty, which indicates all files should be displayed.
Resource: folderColor
Values Color name string or hexadecimal color specification string
Description The color of the default folder icon.
Resource: followSymbolicLinks
Values: True, False (True)
Description When false, filemgr doesn’t follow symbolic links when changing directories.
Resource: iconDirectionVertical
Values: True, False (False)
Description When false, displays files row-by-column. Otherwise, displays files column-by-row.
Resource: iconListStyle
Values: int (0)
Description Saves the state of the "List Options" toggles on the Customize View popup. This is not very human readable and should be changed in the future.
Resource: maxSubWindows
Values: 1-1000 (6)
Description The maximum number of popup sub-folder panes allowed.
Resource: otherEditor
Values: UNIX command (shelltool sh -c "sleep 3 ; vi $FILE")
Description The open method the user wishes to use for opening files. Note this should provide its own window or be started in a shelltool to work correctly. The sleep command is added so the window’s dimensions will be set when the editor starts.
Resource: printScript
Values: UNIX command (cat $FILE | mp -lo | lp)
Description The print method the user wishes to use for printing files.
Resource: shellToolName
Values: UNIX command (cmdtool)
Description The type of tty window to use when running the Custom Command‘s UNIX Shell menu option.
Resource: showHidden
Values: True, False (False)
Description When True, displays hidden files, i.e. dot files.
Resource: sortType
Values: Name, Type, Size, Date (Name)
Description Saves the state of the "Sort By" toggles on the Customize View popup.
Resource: treeView
Values: True, False (False)
Description When True, displays folders in the Tree pane.
Resource: useTextedit
Values: True, False (True)
Description When True, use the texteditor to open files. Otherwise, use the user defined open method described above under "otherEditor".
Resource: viewType
Values: Icon, List, Content (Icon)
Description Saves the state of the "Display Mode" toggles on the Customize View popup.
Resource: wastebasketClosed
Values: True, False (True)
Description When True, start the wastebasket in iconic mode.
Resource: wastebasketHeight
Values: 0-"Height of Screen" (18 lines)
Description Saves the height of the open wastebasket (in pixels).
Resource: wastebasketIconXPosition
Values: 0-"Width of Screen" (0)
Description Saves the X location of the wastebasket icon (in pixels).
Resource: wastebasketIconYPosition
Values: 0-"Height of Screen" (0)
Description Saves the Y location of the wastebasket icon (in pixels).
Resource: wastebasketWidth
Values: 0-"Width of Screen" (40 characters)
Description Saves the width of the open wastebasket (in pixels).
Resource: wastebasketWindowXPosition
Values: 0-"Width of Screen" (0)
Description Saves the X location of the open wastebasket (in pixels).
Resource: wastebasketWindowYPosition
Values: 0-"Height of Screen" (0)
Description Saves the Y location of the open wastebasket (in pixels).
USAGE
filemgr operates via a set of pulldown menus from button stacks in a control panel. Most menu commands operate on the currently selected files. To select a file, click the left mouse button on its icon. To select additional files, click with the middle mouse button on additional files. The menu commands are described below.
File >
Open >
File Opening a document will open the document in the appropriate application. Opening a folder will create a subfolder showing the items in that folder. Opening an application starts the application. This is the default action of a double−clicked file.
With ‘Goto’ Arguments
Treats the text typed in the Goto line as a command line argument (for applications only).
In Document Editor
Opens the selected items using their default open method. See File Manager Properties (below).
Print >
Default Print
Prints the selected items using their default print method. See File Manager Properties below.
Custom Print...
Displays a command window which allows you to print your selected files with a print method you specify.
Create File
Creates an empty file in the file pane.
Create Folder
Creates an empty subfolder in the file pane.
Find...
Displays a command window which allows you to search for files within the specified folders.
Remote Transfer...
Displays a command window which allows you to copy files to and from remote machines. You can make a reference to files on a remote machine by using the format machine_name:file_name. See rcp(1).
Custom Commands
Displays a menu containing custom commands you have created.
Create Command...
Displays a command window which allows you to create the custom commands shown on the menu.
UNIX Shell...
Will bring up a command window where you can directly enter UNIX commands.
View >
Show Tree (or Path)
Toggles between a hierarchical display of folders and a more compact view showing only the path of the current folder being viewed.
Icon by Name
Displays file pane items as large icons sorted by name.
Icon by Type
Displays file pane items as large icons sorted by type and name.
List by Name
Displays file pane items as small icons sorted by name.
List by Type
Displays file pane items as small icons sorted by type and name.
List by Size
Displays file pane items as small icons sorted by size.
List by Date
Displays file pane items as small icons sorted by date.
Customize
Displays a command window which allows you to further customize your view. This includes showing files by content, showing hidden files, and changing icon layout by row or by column.
Edit >
Select All
Selects all files in the current folder.
Cut Places selected files on the clipboard for a pending move operation.
Copy >
File Places selected files on the clipboard for a pending copy operation.
As a Link
Places selected files on the clipboard for a pending link operation.
Paste Pastes files from clipboard into the current folder. Pasted files are linked, copied, or moved, depending on how they were first stored in the clipboard.
Delete
Deletes selected files to the wastebasket. To have files deleted without going to the wastebasket (and with no hope of recovery), select "Really Delete" in File Manager Properties.
Props >
File...
This property sheet allows you to see and change the file attributes of the selected files.
File Manager...
This property sheet allows you to customize the behavior of filemgr. This includes setting the default print and open methods of an item if they do not already have them assigned in the binder database (see binder (1) for more details). When composing a print or open method, be sure to use the $FILE variable within the method where you want the selected filenames to be used. For example, to print a file in a pretty fashion, you can use the print method
"cat $FILE | mp -lo | lp -h".
Goto >
Used in conjunction with the destination entered on the goto line (located at the right of the goto button). To change directories, type the directory name on the goto line and then press Goto.
If nothing is entered on the Goto line, then the first folder displayed on the menu will be "Home", which will return you to your home folder. From the second menu choice on, the menu displays the last folders you have visited. Selecting a folder causes that folder to be opened.
SEE ALSO
find(1), egrep(1), shelltool(1), binder(1)
OpenWindows Version 3.1 DeskSet Reference Guide
"About File Manager" in the Help Handbook available through the Help option on the Workspace menu.
FILES
$HOME/.fmcmd
This file contains the user defined custom commands, which can be referenced by the “Custom Commands” menu.
$HOME/.desksetdefaults
This file saves the state of the DeskSet tools in X resource format. Do not edit this file by hand as changes will be lost when the Server writes to this file!
BUGS
Comments/formatting in the $HOME/.desksetdefaults file can be lost when the server saves the tool’s state.
Choosing a custom command which requires input (such as "rm -i $FILE") can cause filemgr to hang. Custom commands needs to be more robust.
Print methods, open methods, and custom commands depend on the $FILE variable being set properly. Failure to include $FILE will cause the executed command to behave improperly.
SunOS 5.1 — Last change: 12 June 1992