Quelle  locking.rst   Sprache: unbekannt

=======
Locking
=======

This file explains the locking and exclusion scheme used in the PCCARD
and PCMCIA subsystems.


A) Overview, Locking Hierarchy:
===============================

pcmcia_socket_list_rwsem
 - protects only the list of sockets

- skt_mutex
 - serializes card insert / ejection

  - ops_mutex
 - serializes socket operation


B) Exclusion
============

The following functions and callbacks to struct pcmcia_socket must
be called with "skt_mutex" held::

 socket_detect_change()
 send_event()
 socket_reset()
 socket_shutdown()
 socket_setup()
 socket_remove()
 socket_insert()
 socket_early_resume()
 socket_late_resume()
 socket_resume()
 socket_suspend()

 struct pcmcia_callback *callback

The following functions and callbacks to struct pcmcia_socket must
be called with "ops_mutex" held::

 socket_reset()
 socket_setup()

 struct pccard_operations *ops
 struct pccard_resource_ops *resource_ops;

Note that send_event() and `struct pcmcia_callback *callback` must not be
called with "ops_mutex" held.


C) Protection
=============

1. Global Data:
---------------
struct list_head pcmcia_socket_list;

protected by pcmcia_socket_list_rwsem;


2. Per-Socket Data:
-------------------
The resource_ops and their data are protected by ops_mutex.

The "main" struct pcmcia_socket is protected as follows (read-only fields
or single-use fields not mentioned):

- by pcmcia_socket_list_rwsem::

 struct list_head socket_list;

- by thread_lock::

 unsigned int  thread_events;

- by skt_mutex::

 u_int   suspended_state;
 void   (*tune_bridge);
 struct pcmcia_callback *callback;
 int   resume_status;

- by ops_mutex::

 socket_state_t  socket;
 u_int   state;
 u_short   lock_count;
 pccard_mem_map  cis_mem;
 void __iomem   *cis_virt;
 struct { }  irq;
 io_window_t  io[];
 pccard_mem_map  win[];
 struct list_head cis_cache;
 size_t   fake_cis_len;
 u8   *fake_cis;
 u_int   irq_mask;
 void    (*zoom_video);
 int    (*power_hook);
 u8   resource...;
 struct list_head devices_list;
 u8   device_count;
 struct    pcmcia_state;


3. Per PCMCIA-device Data:
--------------------------

The "main" struct pcmcia_device is protected as follows (read-only fields
or single-use fields not mentioned):


- by pcmcia_socket->ops_mutex::

 struct list_head socket_device_list;
 struct config_t  *function_config;
 u16   _irq:1;
 u16   _io:1;
 u16   _win:4;
 u16   _locked:1;
 u16   allow_func_id_match:1;
 u16   suspended:1;
 u16   _removed:1;

- by the PCMCIA driver::

 io_req_t  io;
 irq_req_t  irq;
 config_req_t  conf;
 window_handle_t  win;