Solaris Smartcard Administration Guide

Debugging Smartcard

You can debug smart-card operations on a system by setting the debugging properties. Solaris Smartcard offers standard debugging and a detailed trace of your operations, if specified. If enabled, debugging information is logged to a file. You can control the level and amount of debugging information on a 0–9 scale. Debugging is disabled by default.

The following debugging properties are defined for ocfserv by default:


debugging.filename        = /var/run/ocf.log
debugging                 = 0
/var/run/ocf_log

The name of the file to contain debugging information.

debugging = 0

Debugging is disabled. Debugging is enabled if debugging = 1.


Note –

Previous to the Solaris 8 release, the debugging log file might be called /tmp/ocf_debugfile.


For debugging procedures, see the following:

ProcedureTo Enable Debugging (Console)

Steps
  1. Verify that the ocfserv daemon is enabled.

    The following command provides the status of the service.


    % svcs network/rpc/ocfserv
    

    Note –

    Before you make any changes to Smartcard, you must make sure that the ocfserv daemon is enabled.


  2. (Optional) If necessary, as root, enable the ocfserv daemon.


    # svcadm enable network/rpc/ocfserv
    
  3. Select OCF Server from the Navigation pane.

  4. Double-click the icon that represents the local system.

  5. Select the Debug tab.

  6. Slide the indicator for the OCF Debug Level slider to indicate the level of debugging you want.

  7. Slide the indicator for the Open Card Trace Level slider to indicate the trace level you want.

  8. (Optional) Specify an alternate name for the debug file.

    1. Click Browse to view the file systems on the system.

    2. Type the fully qualified path name for the debug file in the OCF Debug File Location field.

  9. Click the Apply or OK button.

ProcedureTo Enable Debugging (Command Line)

Use the following procedure to enable smart-card debugging.

Steps
  1. Verify that the ocfserv daemon is enabled.

    The following command provides the status of the service.


    % svcs network/rpc/ocfserv
    

    Note –

    Before you make any changes to Smartcard, you must make sure that the ocfserv daemon is enabled.


  2. (Optional) If necessary, as root, enable the ocfserv daemon.


    # svcadm enable network/rpc/ocfserv
    
  3. Enable smart card debugging by setting debugging=1.


    # smartcard -c admin -x modify debugging=1
    

    In the following example, the location of the ocfserv debugging file is changed. The location is changed by using the -x modify debugging.filename option and by specifying a fully qualified file name for the debugging file.


    # smartcard -c admin -x modify debugging.filename=/var/tmp/sc.debug