Symbian File Browser User Guide v1 0 En

Symbian FileBrowser User’s Guide

Document created on 29 September 2011

Version 1.0

Symbian FileBrowser User’s Guide 2

Table of contents 1. Introduction 3

2. Installation 4

3. Basic file operations 5 3.1 Changing the file view 5 3.2 Browsing files and folders 6 3.3 Selecting files on the touch UI 7 3.4 Sorting and filtering files 7 3.5 Creating and deleting files and folders 8 3.6 Copying and moving files and folders 8 3.7 Viewing the properties of drives, folders, and files 10 3.8 Opening files in a designated application 11 3.9 Viewing and editing files in text or hex format 11 3.10 Searching for files 13 3.11 Sending files via message, Bluetooth, or infrared 13 3.12 Modifying FileBrowser settings 14

3.12.1 Modifying the General settings 14 3.12.2 Modifying the Operations settings 15

4. Advanced disk and file management tasks 16 4.1 Additional operations on files and folders 16

4.1.1 Generating lists of files, applications, and messages 16 4.1.2 Setting attributes for files 17 4.1.3 Compressing files 18 4.1.4 Viewing the checksum 18 4.1.5 Setting a file’s date stamp (Touch) 18

4.2 Viewing memory status 19 4.3 Generating a dump of the messaging store walk 19 4.4 Installing and Uninstalling extended errors 20 4.5 Simulating errors 20 4.6 Associating data types with applications 20

Appendix A Priority values for data types 22

Appendix B Symbian OS error codes 23

Change history 29 September 2011 1.0 Initial document release


1. Introduction FileBrowser is a system utility application for Symbian phones running S60 3rd Edition or later. It displays the

hierarchical structure of files, and folders for internal and external drives (such as memory cards). It can be used

to perform general file handling tasks, for example to copy, move, rename, delete, and view file properties. It also

has some additional features, such as the listing of all files or applications in the system.

FileBrowser offers the basic file and folder handling tools for moving, copying, cutting, and pasting files and

folders.

After any operation (such as moving, sending, or deleting files), FileBrowser displays the number of successful

and failed actions. If as single operation is performed and it fails, generic Symbian OS error codes are displayed.

For example, error code —14 is displayed if you attempt to delete a file that is currently being used by another

program. For more information on error codes, see Appendix B, ‘Priority values for data types’.

You can view the listing of error codes for each file and folder entry and also recursively, if applicable, via RDebug.

This document describes how to use FileBrowser on both touch and non-touch Symbian phones.


2. Installation Using the Nokia_FileBrowser.sis file, you can install FileBrowser onto a phone running any of the following:

‒ S60 3rd Edition (initial release).

‒ S60 3rd Edition, Feature Pack 1.

‒ S60 3rd Edition, Feature Pack 2.

‒ S60 5th Edition.

‒ Symbian^3, including Symbian Anna and Symbian Belle.

You can use any of the normal mechanism for transferring the SIS file to your phone and installing it, such as

Nokia Suite installation or transfer over a Bluetooth connection and opening the transferred file.

By default, FileBrowser is installed in the RnD Tools folder, which is created if it’s not present on your phone.

FileBrowser is started as usual by selecting or tapping its application icon.

http://www.developer.nokia.com/info/sw.nokia.com/id/5d967f6a-5ca5-48bc-8dbf-1d91207217a0/Symbian_FileBrowser%20.html�


3. Basic file operations FileBrowser opens displaying a view in which drives can be selected, as shown in Figure 1.

Figure 1: The list of drives in the simple and extended views is shown.

3.1 Changing the file view FileBrowser offers a simple and extended view for displaying file information in the browser.

The simple view displays:

‒ For drives, the drive letter and media type.

‒ For folders the folder name,

‒ For files, the file name and extension.

The extended view displays, in addition to the simple view information:

‒ For drives, the free and total space.

‒ For folders, the creation date and time.

‒ For files, the file size.


To set the view:

1. Go to Options > Settings > File view

2. Select

.

Extended or Simple

3. Toggle

.

Show subdirectory info

4. Select

to add information on the number of files in a folder to the view.

OK

3.2 Browsing files and folders

.

You can navigate the folders in the following ways on non-touch phones:

‒ To navigate one entry up or down: press the Arrow up and Arrow down keys.

‒ To navigate one level lower in the folder hierarchy: press the Arrow right key.

‒ To navigate one level higher until you reach the root level: press the Arrow left key.

‒ To open/launch files: select File > Back/Move up

On the touch UI navigation is performed as follows:

from the menu and press the Select key.

‒ To move one level up in the hierarchy: tap or drag to the left.

‒ To move to lower levels in the hierarchy: select a folder and then drag to the right.

‒ To open files and folders: tap on the desired item.

If the phone has volume keys, use them to scroll the screen up or down one page at a time.

The Star (*) and Hash (#) keys can be used to scroll the screen up or down respectively.

Note: If the phone does not have the Edit key, the Hash key is reserved for the Edit function.


FileBrowser menus are contextual with only those menus and menu items that are applicable to the selected

drive, folder, or file are displayed, as shown in Figure 2.

Figure 2: Options > File menu when a drive is selected and when a file is selected.

3.3 Selecting files on the touch UI You can select files in the touch UI in the following ways:

‒ To select a single item, focus the item and tap .

‒ To select all items, tap and hold .

‒ To select consecutive files, focus the first item and tap . The button changes to to indicate multi—

select mode. Then focus the last item you want to select, and tap again.

3.4 Sorting and filtering files To sort the files in the current folder:

1. Go to Options > View

2. Select an operation:

.

• Sort

•

— to sort the files by name, file extension, date, and size (both in ascending and

descending order).

Order

•

— to list the files in ascending or descending order by name.

Filter entries

•

— to open a pane where you can enter the criteria by which to filter the file names.

Refresh — to update the file view.


To filter the files on the touch UI:

1. Tap . A pane appears above the touch toolbar.

2. In the pane, enter the criteria with which to filter the file names.

Tip: To close the filter pane, press either the Clear key (when all the characters have been deleted from the

pane) or the Cancel

3.5 Creating and deleting files and folders

softkey, or tap .

To create a new file or folder:

1. Navigate to the location where you want to create the new item.

2. Go to Options > File > New

3. Select

.

File or Directory

4. In the text field, enter the name of the item and select

, as needed.

OK

To rename the file or folder:

.

1. Select the item you want to rename.

2. Go to Options > File > Rename

3. In the text field, enter the new name and select

.

OK

To delete a file or folder:

.

1. Select the item you want to delete.

2. Go to Options > File > Delete

3. Select

.

Yes

3.6 Copying and moving files and folders

to confirm.

FileBrowser uses a clipboard to store the file(s) that are cut or copied.

To cut or copy a file:

1. First choose the files:

• Select the single file you want to cut or copy.

• To select all the files in a folder, go to Options > Edit > Select All.


2. Select any of the following items:

• Cut

•

— to remove the file(s) from its current location.

Copy

•

— to copy the file(s) to the clipboard.

Copy to folder… Figure 3 — to copy the file(s) to a specified folder, as shown in .

Figure 3: Example of the Copy To dialogue is shown.

3. To paste the cut or copied items, navigate to the new location and select Paste

To move a file:

.

1. First choose the files:

• Select the single file you want to move.

• To select all the files in a folder, go to Options > Edit > Select All

2. Select

.

Options > Edit > Move to folder…

3. Navigate to the desired drive and folder.

4. Select Move.


3.7 Viewing the properties of drives, folders, and files To display an item’s property information:

1. Select the desired item (drive, folder, or file).

2. Go to Options > File > Properties

• For drives: the drive name, media type, ID, size, amount of free and used space, battery, drive

attributes, and media attributes are provided. Also on touch phones the serial number, manufacturer

ID, Card/BGA, OEM/Application ID, product name, product revision, product serial number,

manufacturing date), block size, cluster size, recommended read buffer size, recommended read

buffer size, and maximum supported file size are displayed if available.

. The following items, as shown in Figure 4, are displayed:

• For folders: path, creation date and time, and attributes.

• For files: path, creation date and time, size, attributes, mime type and the default application for

opening the file.

Figure 4: Example of the properties view for drives, folders and files

3. To close the property dialog, select Ok.


3.8 Opening files in a designated application To open a file:

1. Select the file you want to view.

2. Go to Options > File > Open

3. Select the display method for the file contents:

.

• AppArc

•

— the general Symbian OS Application Architecture framework for starting and managing

applications, and opening files.

DocHandler embed

•

— A common way of opening files in Symbian. The file is displayed by an

application that can handle the type of data, and is embedded in FileBrowser.

DocHandler standalone

•

— The same as above but the application runs in its own process.

Choose a file service… — A system—level service that generates a list of applications that are able to

open the file. After selecting an application from the list, the file is opened similarly as with

the DocHandler embed

4. Select

option.

Back

3.9 Viewing and editing files in text or hex format

to exit.

In FileBrowser, you can view and edit files both in text and hexadecimal modes. The hex mode consists of a series

of two digits (0-9 and A-F) separated by a space. Each of these stands for an 8-bit value. It represents the binary

code in a more readable way.

The supported text formats are: ASCII/ANSI, UTF-8, UTF-16 Little Endian (LE), and UTF-16 Big Endian (BE). UTF

formats are recognised by the byte-order mark, which is a special Unicode character that occurs at the beginning

of a file or a character string.


Figure 5 shows an example illustrating the two options.

Figure 5: An example HTML file viewed in text and in hex modes is shown.

While viewing a file, you can switch the text format from the Options

You can use the volume key to scroll the screen up and down. Alternatively, the Star (*) and Hash (#) keys can be

used to scroll the screen down or up, respectively.

menu.

To edit a file:

1. Select the file you want to edit.

2. Go to Options > File > Edit

3. Select either

.

As text or As hex

Editing is always performed in Unicode because it supports all characters, unlike the more limited ASCII/ANSI

and UTF-8.

.

Tip: When editing a file, you can switch the text format from the Options

4. To save, go to

menu.

Options and select either Save or Save format

The latter option enables you to select the text format: ASCII/ANSI, UTF-8, UTF-16 LE, and UTF-16 BE.

.

When the file is saved as hex, FileBrowser notifies you if there are problems with the format. The correct format

consists of two digits (0-9 and A-F), separated by a space.


3.10 Searching for files To locate files:

1. Go to Options > File > Search

2. Specify the search options.

.

• Search dir

•

— Search folder is by default the current folder.

Recursive/Non-recursive

•

— Recursion enables searching also from subfolders.

Has string

•

— Specifies a text string from the file. You can also use the wildcard character (*).

Min size/Max size

•

— Specifies the minimum and maximum size of the files to be searched. Only valid

for files, not folders.

Min date/Max date

3. Select

— Limits the search to files or folders that were created or modified on or between

specific dates.

Search

The search results are displayed on the screen. To clear the view, select

.

Back

3.11 Sending files via message, Bluetooth, or infrared

.

To send files:

1. Choose the files:

• Select the individual file you want to send.

• To select all the files in a folder, go to Options > Edit > Select All

2. Go to

.

Options > File > Send to

3. Choose the send method, which include one or more of the following depending on the phone’s capabilities

and services:

.

• Via multimedia

•

— to send in a MMS message.

Via e-mail

•

— to send in an email.

Via message

•

— to send in a message

Via Bluetooth

•

— to send over a Bluetooth connections

Via infrared —to send over an infrared link.


3.12 Modifying FileBrowser settings The settings for FileBrowser enable you to modify, for example, the display options of FileBrowser as well as

override some limited aspects of platform security.

Tip: There are two tabs, General and Operations

3.12.1 Modifying the General settings

, and you can toggle between them using the left and right cursor keys.

To modify the display settings on the General

1. Go to

tab:

Options > Settings

2. On the

.

General

•

tab, modify the following options as needed:

Display mode

•

— Toggles between the normal and the full screen display mode.

File view

•

— Toggles between the simple and extended file view.

Show subdirectory info

•

— Specifies that the number of files contained in a folder is displayed in the

File view, when applicable.

Show associated icons

•

— Changes the default icon for the files to those of the default applications

associated with the files.

Remember folder on exit

•

— Specifies that FileBrowser remembers the open folder on exit and reopens

that folder the next time File Browser is opened.

Remember last folder

And on touch UI phones:

— Specifies that FileBrowser remembers which folder had the focus before

navigating into a folder, and when returning to the drive root selects that folder instead of the first in

the folder.

• Show toolbar

3. To exit the settings, select

— Toggles between the touch user interface toolbar enabled and disabled modes.

Back.


3.12.2 Modifying the Operations settings To modify the platform security settings on the Operations

1. Go to Options > Settings.

tab:

2. On the Operations

•

tab, modify the following options as needed:

Support net drives

•

— When enabled, FileBrowser displays remote network drives in the drive list.

Unlock files via SB

•

— Allows FileBrowser to unlock files by activating Secure Backup (SB), which should

cause the applications and servers that have the file locked to release the lock.

Ign. protection atts

•

— Allows FileBrowser to ignore the protection attributes of files or folders. When

enabled, file attributes such as read-only are ignored.

No RD—att copy from Z:

3. To exit the settings, select

— By default, the files on the Z: drive are write-protected and remain that

way also when copied. When enabled, the read-only attribute is removed from a file during copying.

Back.


4. Advanced disk and file management tasks

FileBrowser offers various tools for disk management, including drive formatting, scanning and checking,

password management and setting the name and volume label of a drive.

There are also various file management tools such as list creation (applications, files and attachments), installing

and uninstalling the extended errors feature, and displaying memory information.

4.1 Additional operations on files and folders

4.1.1 Generating lists of files, applications, and messages

FileBrowser enables you to create lists of all files, all open files, mailbox attachments, and all applications on the

phone.

To generate lists of files and applications:

1. Go to Options > Tools

2. Select any of the following options:

.

• All files to a text file

The list is saved as a text file to c:\data\AllFiles.txt, and contains the full file paths and file names of all

the files in the C, D, E and Z drives (or any other drives in the system).

— to generate a list of all the files in the file system.

• All apps to a text file

The list is saved as a text file to c:\data\AllApps.txt, and contains the full file paths and file names of all

the applications installed to the C, D, E and Z drives (or any other local drives on the phone).

— to generate a list of all the applications installed on the phone.

• Show open files

The list is printed on the screen, and the information can be manipulated using the file viewing

features of FileBrowser.

here — to generate a list of all open files.

To exit the Open files view, on non-touch phones press the left cursor key and on touch phones use a

left swipe gesture or tap the up folder icon on the toolbar.


To view a list of all the mailbox attachments in a specific folder:


2. Select

.

Message attachments

3. From the displayed list, select any of the following options:

.

• Inbox

•

— Shows a list of attachments in the Inbox.

Drafts

•

— Shows a list of attachments in the Drafts folder.

Sent items

•

— Shows a list of attachments in the Sent Items folder.

Outbox

The list of attachments contained in the selected folder is printed on the screen, and the information

can be manipulated using the file viewing features of FileBrowser.

— Shows a list of attachments in the Outbox folder.

4. To exit the view, on non-touch phones press the left cursor key and on touch phones use a left swipe gesture

or tap the up folder icon on the toolbar.

4.1.2 Setting attributes for files

You can set attributes for a selected file or folder. The attributes that can be set are: Archive, Hidden, Read only,

System and Recurse (only for folders).

To set the attributes:

1. Select the file (or folder) you require.

2. Go to Options > File > Set attributes

3. Set the desired value for the

.

Archive, Hidden, Read only and System

•

attributes:

On

•

— forces the attribute on.

Off

•

—forces the attribute off.

Skip

And for

— the current value is not changed.

Recurse

•

:

Recursive

•

— sets the folder as recursive.

Non-recursive

4. Select

— sets the folder as non-recursive.

Save.


4.1.3 Compressing files

FileBrowser can compress files with the GZip utility. Note that only one file can be compressed at a time.

To compress files:

1. Select the file you want to compress.

2. Go to Options > File > Compress with GZip

The compressed file is saved to the current folder, appended with .gz.

.

Similarly, to decompress a file, select Options > File > Decompress with GZip

4.1.4 Viewing the checksum

.

Checksum helps to protect the integrity of data that needs to be transferred, for example, from one phone to

another.

To view the checksums on different algorithms (MD5, MD2, SHA-1), go to Options > File > Checksum

4.1.5 Setting a file’s date stamp (Touch)

.

The Touch

To do this:

option lets you set a file’s date stamp to the current date.

1. Select the file whose date you want to change.

2. Go to Options > File > Touch.


4.2 Viewing memory status FileBrowser can display the amount of used and free memory in bytes for RAM and each disk type, in a dialogue

as shown in Figure 6.

To display the memory info:

1. On the main view, select the drive whose memory information you want to view.


3. Select

.

Memory info

.

Figure 6: The memory information dialogue is shown.

4. To close the memory info dialogue, select Ok

4.3 Generating a dump of the messaging store walk

.

FileBrowser can generate the text file c:\data\MsgStoreWalk.txt, which contains information about the entries

stored in the active messaging store.

The entries in the text file are indented based on their hierarchy. The information provided on each entry

includes the ID, service ID, related ID, type, mtm, date, size, error, biotype, mtmdata1, mtmdata2, mtmdata3,

description and details.

To generate a dump of messaging store walk, go to Options > Tools > Dump msg. store walk.


4.4 Installing and Uninstalling extended errors FileBrowser can be used to manage extended errors on the phone. When the extended errors are enabled, the

error dialog includes the panic category and the error code (for example, App. closed: APPNAME KERN—EXEC

3). Also system errors, which are hidden by default, are displayed on the screen.

To enable extended errors:


6. Select

.

Install extended errors

Once extended errors have been installed the

.

Tools option changes to Uninstall extended errors

4.5 Simulating errors

and can be

used to remove this feature if required.

To simulate errors:

1. Go to Options > Tools > Error simulate

2. Select any of the following options:

.

• Leave

•

— Calls the User::Leave function with a leave code you can define.

Panic

•

— Calls the User::Panic function with panic category name and panic code you can define.

Exception

3. On the next screen, depending on the chosen error item, enter the code that is called.

— Calls the User::RaiseException function with exception code you can define.

For information on extended errors, see Chapter 4.5, ‘Installing and Uninstalling extended errors’.

4.6 Associating data types with applications A data type (or MIME type) is an identifier for audio, image, text, and video file formats among other. The data

type is expressed as a two-part identifier, such as text/plain or audio/mpeg. Files of a certain data type can be

opened with an application assigned for this purpose. If there are several possible applications, the one that has

the highest priority value is used.

FileBrowser can display the available data types and associated applications. You can also change these

mappings, as well as assign a priority value to an application for handling a data type.


To see the data types and change their associations:

1. Go to Options > Tools > Edit data types

2. Select

.

Options > Change mapping Figure 7 and a list of applications is displayed, as shown in :

Figure 7: Application selection view is shown.

Tip: If changes have been made outside FileBrowser, select Refresh

Select an application from the

to update the list.

Select app list and the Select priority

3. In the

view is opened.

Select Priority

Appendix A

view, define the level of priority that the application has for opening the data type. For

more information on the priority options, see , ‘Priority values for data types’.

To restore default mappings later, select Options > Tools > Edit data types > Set to default mapping.


Appendix A Priority values for data types Table 1 lists the priority values that you can use when associating an application with a particular data type.

Priority value associated with a data (MIME) type:

Use to associate an application with a data type:

Maximum Choose this priority for mistrusted applications that reside in \private\10003a3f\import\apps. This value is a threshold priority that prevents any mistrusted applications from claiming a priority higher than the threshold.

High Choose this priority for an application that is always, without exceptions, used to handle the data type. Use sparingly.

Normal Choose this priority when the data type is the primary type for the application. For example, text/plain files for a text editor.

Low Choose this priority when the data type is a secondary type for the application. For example, text/plain files for a web browser.

Last resort Choose this priority when the data type is the last resort for the application, that is, when there are no other options.

Table 1: Priority values for associating an application with a data type are listed.


Appendix B Symbian OS error codes Table 2 provides a list of the generic Symbian OS error codes (from -1 to -46).

Table 2: Generic Symbian OS error codes are listed.

Name Value Suggested Text

KErrNotFound -1 Unable to find the specified object

KErrGeneral -2 General (unspecified) error

KErrCancel -3 The operation was cancelled

KErrNoMemory -4 Not enough memory. Close some applications and try again

KErrNotSupported -5 The operation requested is not supported

KErrArgument -6 Bad request

KErrTotalLossOfPrecision -7 Total loss of precision

KErrBadHandle -8 Bad object

KErrOverflow -9 Overflow

KErrUnderflow -10 Underflow

KErrAlreadyExists -11 Already exists

KErrPathNotFound -12 Unable to find the specified folder

KErrDied -13 Closed

KErrInUse -14 The specified object is currently in use by another program

KErrServerTerminated -15 Server has closed

KErrServerBusy -16 Server busy

KErrCompletion -17 Completion error

KErrNotReady -18 Not ready

KErrUnknown -19 Unknown error

KErrCorrupt -20 Corrupt

KErrAccessDenied -21 Access denied

KErrLocked -22 Locked

KErrWrite -23 Failed to write

KErrDisMounted -24 Wrong disk present

KErrEof -25 Unexpected end of file

KErrDiskFull -26 Disk full

KErrBadDriver -27 Bad device driver


Name Value Suggested Text

KErrBadName -28 Bad name

KErrCommsLineFail -29 Comms line failed

KErrCommsFrame -30 Comms frame error

KErrCommsOverrun -31 Comms overrun error

KErrCommsParity -32 Comms parity error

KErrTimedOut -33 Timed out

KErrCouldNotConnect -34 Failed to connect

KErrCouldNotDisconnect -35 Failed to disconnect

KErrDisconnected -36 Disconnected

KErrBadLibraryEntryPoint -37 Bad library entry point

KErrBadDescriptor -38 Bad descriptor

KErrAbort -39 Interrupted

KErrTooBig -40 Too big

KErrDivideByZero -41 Divide by zero

KErrBadPower -42 Batteries too low

KErrDirFull -43 Folder full

KErrHardwareNotAvailable -44

KErrSessionClosed -45

KErrPermissionDenied -46 Permission denied when attempting operation


Copyright © 2011 Nokia Corporation. All rights reserved.

Nokia and Nokia Developer are trademarks or registered trademarks of Nokia Corporation. Other product and

company names mentioned herein may be trademarks or trade names of their respective owners.

The information in this document is provided ‘as is’, with no warranties whatsoever, including any warranty of

merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal,

specification, or sample. This document is provided for informational purposes only.

Disclaimer

Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to

implementation of information presented in this document. Nokia Corporation does not warrant or represent

that such use will not infringe such rights.

Nokia Corporation retains the right to make changes to this document at any time, without notice.

A licence is hereby granted to download and print a copy of this document for personal use only. No other licence

to any other intellectual property rights is granted herein.

Licence

Documents

Symbian File Browser User Guide v1 0 En