'\" t
.\"     Title: vomses
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 05/28/2014
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "VOMSES" "5" "05/28/2014" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
vomses \- The VOMS server contact table
.SH "SYNOPSIS"
.sp
\fB/etc/vomses\fR
.sp
\fB~/\&.glite/vomses\fR
.SH "DESCRIPTION"
.sp
This manual page describes the format of \fIvomses\fR files\&. \fIvomses\fR files contain contact information for VOMS servers and are typically organized in the \fB/etc/vomses\fR directory\&. A \fIvomses\fR file is a simple text file which contains one or more lines formatted as follows:
.sp
"alias" "hostname" "port" "server DN" "vo_name"
.sp
Where:
.sp
\fBalias\fR: an alias that can be used for this VOMS server (this is typically identical to the vo_name)
.sp
\fBhostname\fR: the hostname where the VOMS server is running
.sp
\fBvo_name\fR: the name of the VO served by the VOMS server
.sp
\fBport\fR: the port where the VOMS server is listening for incoming requests
.sp
\fBserver DN\fR: the certificate subject of the VOMS server
.sp
System wide VOMSES configuration is maintained in the \fB/etc/vomses\fR file or directory\&. If \fB/etc/vomses\fR is a directory, all the files contained in such directory are parsed looking for VOMS contact information\&.
.sp
A user can define its custom \fBvomses\fR configuration in the \fB~/\&.glite/vomses\fR file or directory, which will be parsed in the same way as just described\&.
.SH "EXAMPLES"
.sp
The following is an example of valid vomes file for the \fBcms\fR VO:
.sp
.if n \{\
.RS 4
.\}
.nf
"cms" "lcg\-voms\&.cern\&.ch" "15002" "/DC=ch/DC=cern/OU=computers/CN=lcg\-voms\&.cern\&.ch" "cms"
"cms" "voms\&.cern\&.ch" "15002" "/DC=ch/DC=cern/OU=computers/CN=voms\&.cern\&.ch" "cms"
.fi
.if n \{\
.RE
.\}
.SH "BUGS"
.sp
To report bugs or ask for support, use GGUS: https://ggus\&.eu/pages/home\&.php
.SH "AUTHORS"
.sp
Andrea Ceccanti <andrea\&.ceccanti@cnaf\&.infn\&.it>
.sp
Daniele Andreotti <daniele\&.andreotti@cnaf\&.infn\&.it>
.sp
Valerio Venturi <valerio\&.venturi@cnaf\&.infn\&.it>
.SH "SEE ALSO"
.sp
voms\-proxy\-destroy(1), voms\-proxy\-info(1), vomsdir(5)
.SH "COPYING"
.sp
Copyright 2012 Istituto Nazionale di Fisica Nucleare
.sp
Licensed under the Apache License, Version 2\&.0 (the "License"); you may not use this file except in compliance with the License\&. You may obtain a copy of the License at
.sp
.if n \{\
.RS 4
.\}
.nf
http://www\&.apache\&.org/licenses/LICENSE\-2\&.0
.fi
.if n \{\
.RE
.\}
.sp
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied\&. See the License for the specific language governing permissions and limitations under the License\&.