nsproxy.h 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. #ifndef _LINUX_NSPROXY_H
  2. #define _LINUX_NSPROXY_H
  3. #include <linux/spinlock.h>
  4. #include <linux/sched.h>
  5. struct mnt_namespace;
  6. struct uts_namespace;
  7. struct ipc_namespace;
  8. struct pid_namespace;
  9. struct fs_struct;
  10. /*
  11. * A structure to contain pointers to all per-process
  12. * namespaces - fs (mount), uts, network, sysvipc, etc.
  13. *
  14. * The pid namespace is an exception -- it's accessed using
  15. * task_active_pid_ns. The pid namespace here is the
  16. * namespace that children will use.
  17. *
  18. * 'count' is the number of tasks holding a reference.
  19. * The count for each namespace, then, will be the number
  20. * of nsproxies pointing to it, not the number of tasks.
  21. *
  22. * The nsproxy is shared by tasks which share all namespaces.
  23. * As soon as a single namespace is cloned or unshared, the
  24. * nsproxy is copied.
  25. */
  26. struct nsproxy {
  27. atomic_t count;
  28. struct uts_namespace *uts_ns;
  29. struct ipc_namespace *ipc_ns;
  30. struct mnt_namespace *mnt_ns;
  31. struct pid_namespace *pid_ns_for_children;
  32. struct net *net_ns;
  33. };
  34. extern struct nsproxy init_nsproxy;
  35. /*
  36. * the namespaces access rules are:
  37. *
  38. * 1. only current task is allowed to change tsk->nsproxy pointer or
  39. * any pointer on the nsproxy itself
  40. *
  41. * 2. when accessing (i.e. reading) current task's namespaces - no
  42. * precautions should be taken - just dereference the pointers
  43. *
  44. * 3. the access to other task namespaces is performed like this
  45. * rcu_read_lock();
  46. * nsproxy = task_nsproxy(tsk);
  47. * if (nsproxy != NULL) {
  48. * / *
  49. * * work with the namespaces here
  50. * * e.g. get the reference on one of them
  51. * * /
  52. * } / *
  53. * * NULL task_nsproxy() means that this task is
  54. * * almost dead (zombie)
  55. * * /
  56. * rcu_read_unlock();
  57. *
  58. */
  59. static inline struct nsproxy *task_nsproxy(struct task_struct *tsk)
  60. {
  61. return rcu_dereference(tsk->nsproxy);
  62. }
  63. int copy_namespaces(unsigned long flags, struct task_struct *tsk);
  64. void exit_task_namespaces(struct task_struct *tsk);
  65. void switch_task_namespaces(struct task_struct *tsk, struct nsproxy *new);
  66. void free_nsproxy(struct nsproxy *ns);
  67. int unshare_nsproxy_namespaces(unsigned long, struct nsproxy **,
  68. struct cred *, struct fs_struct *);
  69. int __init nsproxy_cache_init(void);
  70. static inline void put_nsproxy(struct nsproxy *ns)
  71. {
  72. if (atomic_dec_and_test(&ns->count)) {
  73. free_nsproxy(ns);
  74. }
  75. }
  76. static inline void get_nsproxy(struct nsproxy *ns)
  77. {
  78. atomic_inc(&ns->count);
  79. }
  80. #endif