maki/openairinterface5g
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e5eda2bed0f2e1e7cd0dcfea5ccaea0b99869ebd
openairinterface5g/openair3/MESH/RRM/rrc_rrm_msg.h
T
Cedric Roux 56c66c09aa - Fix: avoid infinite loop on mulitcast read thread if no data to read 
Pre-ci test passed

git-svn-id: http://svn.eurecom.fr/openair4G/trunk@4000 818b1a75-f10b-46b9-bf7c-635c3b92a50f
2013-06-25 09:05:02 +00:00

479 lines
23 KiB
C
Raw Blame History

/*!
*******************************************************************************
\file rrc_msg.h
\brief Fichier d'entete contenant les declarations des types, des defines ,
et des fonctions relatives aux messages RRC-RRM ou RRC-RRCI.
Les fonctions servent à créer le buffer de message, remplir
l'entete et copier les parametres de fonction. Chaque fonction
retourne le message qui pourra être envoye sur le socket entre le
CMM et le RRM ou RRCI.
\author BURLOT Pascal
\date 17/07/08
\par Historique:
L.IACOBELLI 2009-10-19
+ sensing messages
*******************************************************************************
*/
#ifndef __RRC_RRM_MSG_H
#define __RRC_RRM_MSG_H
#include "L3_rrc_defs.h"
#include "COMMON/mac_rrc_primitives.h"
#ifdef OPENAIR2_IN
#include "rrm_sock.h"
#else
#include "RRC/MESH/rrc_rrm_interface.h"
#endif
//#include "../../../openair2/RRC/MESH/rrc_rrm_interface.h"
#ifdef __cplusplus
extern "C" {
#endif
/*!
*******************************************************************************
\brief Enumeration des messages entre RRM/RRCI et le RRC
*/
typedef enum {
RRM_RB_ESTABLISH_REQ = 0 , ///< Message RRM->RRC : requete d'etablissement d'un RB
RRC_RB_ESTABLISH_RESP , ///< Message RRC->RRM : reponse d'etablissement d'un RB
RRC_RB_ESTABLISH_CFM , ///< Message RRC->RRM : confirmation d'etablissement d'un RB
RRM_RB_MODIFY_REQ , ///< Message RRM->RRC : requete de modification d'un RB
RRC_RB_MODIFY_RESP , ///< Message RRC->RRM : reponse de modification d'un RB
RRC_RB_MODIFY_CFM , ///< Message RRC->RRM : confirmation de modification d'un RB
RRM_RB_RELEASE_REQ , ///< Message RRM->RRC : requete de liberation d'un RB
RRC_RB_RELEASE_RESP , ///< Message RRC->RRM : reponse de liberation d'un RB
RRC_MR_ATTACH_IND , ///< Message RRC->RRM : indication d'attachement d'un MR
RRM_SENSING_MEAS_REQ , ///< Message RRM->RRC : requete de configuration de mesure sensing
RRC_SENSING_MEAS_RESP , ///< 10Message RRC->RRM : reponse de configuration de mesure sensing
RRC_CX_ESTABLISH_IND , ///< Message RRC->RRM : indication de connexion etablie
RRC_PHY_SYNCH_TO_MR_IND , ///< Message RRC->RRM : indication de synchronisation physique a un MR
RRC_PHY_SYNCH_TO_CH_IND , ///< Message RRC->RRM : indication de synchronisation physique a un CH
RRCI_CX_ESTABLISH_RESP , ///< Message RRCI->RRC : reponse de connexion etablie
RRC_SENSING_MEAS_IND , ///< Message RRC->RRM : indication de nouvel mesure de sensing
RRM_SENSING_MEAS_RESP , ///< Message RRM->RRC : reponse a l'indication de nouvel mesure de sensing
RRC_RB_MEAS_IND , ///< Message RRC->RRM : indication de nouvel mesure sur un RB
RRM_RB_MEAS_RESP , ///< Message RRM->RRC : reponse a l'indication de nouvel mesure sur un RB
RRM_INIT_CH_REQ , ///< Message RRM->RRC : init d'un CH
RRCI_INIT_MR_REQ , ///< 20Message RRM->RRC : init d'un MR
RRM_INIT_MON_REQ , ///< Message RRM->RRC : initiation of a scanning monitoring
RRM_INIT_SCAN_REQ , ///< Message RRM->RRC : initiation of a scanning process
RRC_INIT_SCAN_REQ , ///< Message RRC->RRM : initiation of a scanning process
//UPDATE_SENS_RESULTS_3 , ///< Message IP : update to send to CH/FC //mod_lor_10_01_25
RRM_END_SCAN_REQ , ///< Message RRM->RRC : end of a scanning process
RRC_END_SCAN_REQ , ///< Message RRC->RRM : end of a scanning process
RRC_END_SCAN_CONF , ///< Message RRC->RRM : end of a scanning process ack
RRC_INIT_MON_REQ , ///< Message RRM->RRC : initiation of a scanning monitoring
//OPEN_FREQ_QUERY_4 , ///< Message IP : BTS to ask free frequencies to FC
//UPDATE_OPEN_FREQ_7 , ///< 30Message IP : list of frequencies usable by the secondary network
//UPDATE_SN_OCC_FREQ_5 , ///< Message IP : BTS sends used freq. to FC
RRM_UP_FREQ_ASS , ///< Message RRM->RRC : BTS assigns channels to SUs (scen1)
RRM_END_SCAN_CONF , ///< Message RRM->RRC : end of a scanning process
RRC_UP_FREQ_ASS , ///< Message RRC->RRM ://mod_lor_10_06_04
RRM_UP_FREQ_ASS_SEC , ///< Message RRM->RRC : CH assigns channels to SUs (scen2) //add_lor_10_11_05
RRC_UP_FREQ_ASS_SEC , ///< Message RRC->RRM : frequencies assigned by CH (scen2) //add_lor_10_11_05
/*RRC_ASK_FOR_FREQ , ///< Message RRC->RRM : in FC/CH to report a frequency query
RRM_OPEN_FREQ , ///< Message RRM->RRC : FC communicates open frequencies
RRM_UPDATE_SN_FREQ , ///< Message RRM->RRC : BTS sends used freq. to FC
RRC_UPDATE_SN_FREQ , ///< Message RRC->RRM : FC receives used freq. from BTS
RRM_CLUST_SCAN_REQ , ///< Message RRM->RRC : CH1 contacts CH2 to collaborate for the sensing process
RRC_CLUST_SCAN_REQ , ///< Message RRC->RRM : CH2 receive request to collaborate for the sensing process from CH1
RRM_CLUST_SCAN_CONF , ///< Message RRM->RRC : CH2 confirmrs the beginning of a collaboration process
RRM_CLUST_MON_REQ , ///< Message RRM->RRC : CH1 contacts CH2 to collaborate for the monitoring process
RRC_CLUST_MON_REQ , ///< Message RRC->RRM : CH2 receive request to collaborate for the monitoring process from CH1
RRM_CLUST_MON_CONF , ///< Message RRM->RRC : CH2 confirmrs the beginning of a monitoring process
RRM_END_SCAN_CONF , ///< Message RRM->RRC : CH2 confirmrs the end of the collaborative sensing process at CH1
RRM_INIT_CONN_REQ , ///< Message RRM->RRC : SU 1 requests a connection to SU 2
RRC_INIT_CONN_CONF , ///< Message RRM->RRC : Confirm from SU2 about the requested connection
RRM_FREQ_ALL_PROP , ///< Message RRM->RRC : SU1 sends a proposition of teh frequencies to use
RRC_FREQ_ALL_PROP_CONF , ///< Message RRC->RRM : SU1 receives a confirm on the usable channels
RRM_REP_FREQ_ALL , ///< Message RRM->RRC : SU1 reports to CH the possible channels
RRC_REP_FREQ_ACK , ///< Message RRC->RRM : CH informs all SUs about a channel allocated to 2 SUs
RRC_INIT_CONN_REQ , ///< Message RRC->RRM : Request from SU1 to establish a connection
RRM_CONN_SET , ///< Message RRC->RRM : Response to SU1 and connection settings communicated to rcc
RRC_FREQ_ALL_PROP , ///< Message RRC->RRM : SU1 proposition of frequencies to use
RRM_FREQ_ALL_PROP_CONF , ///< Message RRC->RRM : SU2 choise of frequencies to use
RRC_REP_FREQ_ALL , ///< Message RRM->RRC : SU1 reports to CH the possible channels
RRM_REP_FREQ_ACK , ///< Message RRC->RRM : CH informs all SUs about a channel allocated to 2 SUs
*/NB_MSG_RRC_RRM ///< Nombre de message RRM-RRC
} MSG_RRC_RRM_T ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_init_ch_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
LCHAN_DESC Lchan_desc_srb0 ; //!< Logical Channel Descriptor Array
LCHAN_DESC Lchan_desc_srb1 ; //!< Logical Channel Descriptor Array
L2_ID L2_id ; //!< Layer 2 (MAC) IDs for link
} rrm_init_ch_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_init_mr_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
LCHAN_DESC Lchan_desc_srb0 ; //!< Logical Channel Descriptor Array
LCHAN_DESC Lchan_desc_srb1 ; //!< Logical Channel Descriptor Array
unsigned char CH_index ; //!< Layer 2 (MAC) IDs for CH
} rrci_init_mr_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_rb_establish_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id[2] ; //!< Layer 2 (MAC) IDs for link
LCHAN_DESC Lchan_desc ; //!< Logical Channel Descriptor Array
MAC_RLC_MEAS_DESC Mac_rlc_meas_desc ; //!< MAC/RLC Measurement descriptors for RB
L3_INFO_T L3_info_t ; //!< Optional L3 Information
unsigned char L3_info[MAX_L3_INFO] ; //!< Type of L3 Information
} rrm_rb_establish_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_rb_establish_cfm() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
RB_ID Rb_id ; //!< Radio Bearer ID used by RRC
RB_TYPE RB_type ; //!< Radio Bearer Type
} rrc_rb_establish_cfm_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_rb_modify_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
LCHAN_DESC Lchan_desc ; //!< Logical Channel Descriptor Array
MAC_RLC_MEAS_DESC Mac_meas_desc ; //!< MAC/RLC Measurement descriptors for RB
RB_ID Rb_id ; //!< Radio Bearer ID
} rrm_rb_modify_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres des fonctions rrc_rb_modify_cfm() et
rrm_rb_release_req() dans une structure permettant le passage des
parametres via un socket
*/
typedef struct {
RB_ID Rb_id ; //!< Radio Bearer ID
} rrc_rb_modify_cfm_t ,
rrm_rb_release_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_MR_attach_ind() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID
} rrc_MR_attach_ind_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_sensing_meas_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID
SENSING_MEAS_DESC Sensing_meas_desc ; //!< Sensing Measurement Descriptor
} rrm_sensing_meas_req_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_cx_establish_ind() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID
L3_INFO_T L3_info_t ; //!< Type of L3 Information
unsigned char L3_info[MAX_L3_INFO] ; //!< Optional L3 Information
RB_ID DTCH_B_id ; //!< RBID of broadcast IP service (MR only)
RB_ID DTCH_id ; //!< RBID of default IP service (MR only)
} rrc_cx_establish_ind_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_phy_synch_to_CH_ind() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
unsigned int Ch_index ; //!< Clusterhead index
L2_ID L2_id ; //!< L2_ID du MR
} rrc_phy_synch_to_CH_ind_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_phy_synch_to_MR_ind() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< L2_ID du CH
} rrc_phy_synch_to_MR_ind_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrci_cx_establish_resp() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ;
unsigned char L3_info[MAX_L3_INFO] ; //!< Optional L3 Information
L3_INFO_T L3_info_t ; //!< Type of L3 Information
} rrci_cx_establish_resp_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_sensing_meas_ind_t() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 ID (MAC) of sensing node
unsigned int NB_meas ; //!< Layer 2 ID (MAC) of sensing node
SENSING_MEAS_T Sensing_meas[NB_SENS_MAX]; //!< first Sensing Information
} rrc_sensing_meas_ind_t ;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_rb_meas_ind() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
RB_ID Rb_id ; //!< Radio Bearer ID
L2_ID L2_id ; //!< Layer 2 (MAC) IDs for link
MEAS_MODE Meas_mode ; //!< Measurement mode (periodic or event-driven)
MAC_RLC_MEAS_T Mac_rlc_meas ; //!< MAC/RLC measurements
} rrc_rb_meas_ind_t;
/*!
*******************************************************************************
\brief Definition des parametres de les fonctions
rrm_update_sens()dans une structure permettant le passage
des parametres via un socket
*/
/*typedef struct {
L2_ID L2_id ; //!< Layer 2 ID (MAC) of sensing node
unsigned int NB_info ; //!< number of sensed channels
Sens_ch_t Sens_meas[NB_SENS_MAX] ; //!< sensing information
} rrm_update_sens_t ; */
/*!
*******************************************************************************
\brief Definition des parametres des fonctions rrm_init_mon_req(),
rrc_init_mon_req(), rrm_clust_mon_req(), rrc_clust_mon_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of destination
unsigned int NB_chan ; //!< Number of channels to scan
unsigned int interval ; //!< Time between two sensing sessions
unsigned int ch_to_scan[NB_SENS_MAX]; //!< Vector of channels to scan
} rrm_init_mon_req_t,
rrc_init_mon_req_t/*,
rrm_clust_mon_req_t,
rrc_clust_mon_req_t*/;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_init_scan_req() dans
une structure permettant le passage des parametres via un socket
*/
//mod_lor_10_03_12++
typedef struct {
unsigned int Start_fr; //!< Lowest frequency considered (MHz)
unsigned int Stop_fr; //!< Highest frequency considered (MHz)
unsigned int Meas_band; //!< Measurement bandwidth (KHz)
unsigned int Meas_tpf; //!< Measurement time per sub-band
unsigned int Nb_channels; //!< Number of sub-bands
unsigned int Overlap; //!< Overlap factor (%)
unsigned int Sampl_freq; //!< Sampling frequency (Ms/s)
} rrm_init_scan_req_t;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrc_init_scan_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of Fusion Centre
unsigned int Start_fr; //!< Lowest frequency considered (MHz)
unsigned int Stop_fr; //!< Highest frequency considered (MHz)
unsigned int Meas_band; //!< Measurement bandwidth (KHz)
unsigned int Meas_tpf; //!< Measurement time per sub-band
unsigned int Nb_channels; //!< Number of sub-bands
unsigned int Overlap; //!< Overlap factor (%)
unsigned int Sampl_freq; //!< Sampling frequency (Ms/s)
} rrc_init_scan_req_t;
//mod_lor_10_03_12--
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_end_scan_req() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of destination sensor/FC
} rrm_end_scan_req_t,
rrc_end_scan_req_t,
rrc_end_scan_conf_t;
/*!
*******************************************************************************
\brief Definition des parametres de la fonction rrm_up_freq_ass() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of SU
unsigned int NB_chan ; //!< Number of channels
CHANNEL_T ass_channels[NB_SENS_MAX]; //!< description of assigned channelS
} rrm_up_freq_ass_t ;
/*! //add_lor_10_11_05
*******************************************************************************
\brief Definition des parametres de la fonction rrm_up_freq_ass() dans
une structure permettant le passage des parametres via un socket
*/
typedef struct {
L2_ID L2_id [NB_SENS_MAX] ; //!< Layer 2 (MAC) ID of SU source
L2_ID L2_id_dest [NB_SENS_MAX] ; //!< Layer 2 (MAC) ID of SU source
unsigned int NB_all ; //!< Number of allocated channels
CHANNEL_T ass_channels[NB_SENS_MAX]; //!< description of assigned channelS
} rrm_up_freq_ass_sec_t ;
///< TYPEDEF VIA IP
//mod_lor_10_04_27++
/*!
*******************************************************************************
\brief Definition des parametres de les fonctions
rrm_update_sens()dans une structure permettant le passage
des parametres via un socket
*/
/*typedef struct {
L2_ID L2_id ; //!< Layer 2 ID (MAC) of sensing node
unsigned int NB_info ; //!< Number of sensed channels
Sens_ch_t Sens_meas[NB_SENS_MAX] ; //!< Sensing information
double info_time ; //!< Data of the information
} rrm_update_sens_t ; */
/*!
*******************************************************************************
\brief Definition des parametres de les fonctions rrm_ask_for_freq() et rrc_ask_for_freq()dans
une structure permettant le passage des parametres via un socket
*/
/*typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of Fusion Centre
QOS_CLASS_T QoS ; //!< QoS required; if 0 all QoS at disposition
} open_freq_query_t;*/
/*!
*******************************************************************************
\brief Definition des parametres de les fonctions
rrc_open_freq() et rrm_open_freq() dans une structure permettant le passage
des parametres via un socket
*/
/*typedef struct {
double date;
L2_ID L2_id ; //!< Layer 2 ID (MAC) of FC/CH
unsigned int NB_chan ; //!< number of free channels
CHANNEL_T fr_channels[NB_SENS_MAX]; //!< description of free channelS
} update_open_freq_t;*/
/*!
*******************************************************************************
\brief Definition des parametres des fonctions rrm_update_SN_freq() et
rrm_update_SN_freq()dans
une structure permettant le passage des parametres via un socket
*/
/*typedef struct {
L2_ID L2_id ; //!< Layer 2 (MAC) ID of FC/BTS
unsigned int NB_chan ; //!< Number of channels
unsigned int occ_channels[NB_SENS_MAX]; //!< Vector of channels
} update_SN_occ_freq_t;*/
//mod_lor_10_04_27--
#ifdef TRACE
extern const char *Str_msg_rrc_rrm[NB_MSG_RRC_RRM] ;
#endif
/* Rappel : les paramètres sont identiques aux fonctions
* (sans le prefixe msg_ ) du fichier: L3_rrc_interface.h
*/
msg_t *msg_rrm_rb_establish_req( Instance_t inst,
const LCHAN_DESC *Lchan_desc, const MAC_RLC_MEAS_DESC *Mac_rlc_meas_desc,
L2_ID *L2_id, Transaction_t Trans_id, unsigned char *L3_info, L3_INFO_T L3_info_t );
msg_t *msg_rrm_rb_modify_req( Instance_t inst,
const LCHAN_DESC *Lchan_desc, const MAC_RLC_MEAS_DESC *Mac_meas_desc,
RB_ID Rb_id, Transaction_t Trans_id );
msg_t *msg_rrm_rb_release_req( Instance_t inst, RB_ID Rb_id, Transaction_t Trans_id );
msg_t *msg_rrm_sensing_meas_req( Instance_t inst,
L2_ID L2_id, SENSING_MEAS_DESC Sensing_meas_desc, Transaction_t Trans_id ) ;
msg_t *msg_rrci_cx_establish_resp( Instance_t inst,
Transaction_t Trans_id,L2_ID L2_id,
unsigned char *L3_info, L3_INFO_T L3_info_t );
msg_t *msg_rrm_sensing_meas_resp( Instance_t inst, Transaction_t Trans_id );
msg_t *msg_rrm_rb_meas_resp( Instance_t inst, Transaction_t Trans_id );
msg_t *msg_rrm_init_ch_req( Instance_t inst, Transaction_t Trans_id,
const LCHAN_DESC *Lchan_desc_srb0, const LCHAN_DESC *Lchan_desc_srb1,
L2_ID L2_id ) ;
msg_t *msg_rrci_init_mr_req( Instance_t inst,
Transaction_t Trans_id, const LCHAN_DESC *Lchan_desc_srb0,
const LCHAN_DESC *Lchan_desc_srb1, unsigned char CH_index);
msg_t *msg_rrm_init_mon_req(Instance_t inst, L2_ID L2_id, unsigned int NB_chan,
unsigned int interval, unsigned int *ch_to_scan, Transaction_t Trans_id );
msg_t *msg_rrm_init_scan_req(Instance_t inst, unsigned int Start_fr, unsigned int Stop_fr,unsigned int Meas_band,
unsigned int Meas_tpf, unsigned int Nb_channels,unsigned int Overlap, unsigned int Sampl_freq, Transaction_t Trans_id ); //mod_lor_10_03_12
msg_t *msg_rrm_end_scan_req( Instance_t inst, L2_ID L2_id, Transaction_t Trans_id );
msg_t *msg_rrm_up_freq_ass( Instance_t inst, L2_ID L2_id, unsigned int NB_chan, CHANNEL_T *ass_channels);
msg_t *msg_rrm_end_scan_conf( Instance_t inst, Transaction_t Trans_id);
msg_t *msg_rrm_up_freq_ass_sec( Instance_t inst, L2_ID *L2_id, L2_ID *L2_id_dest,unsigned int NB_all, CHANNEL_T *ass_channels);//add_lor_10_11_05
/*//mod_lor_10_04_27++
///MESSAGES VIA IP
msg_t *msg_update_sens_results_3( Instance_t inst, L2_ID L2_id, unsigned int NB_chan, Sens_ch_t *Sens_meas, Transaction_t Trans_id );
msg_t *msg_open_freq_query_4( Instance_t inst, L2_ID L2_id, QOS_CLASS_T QoS, Transaction_t Trans_id );
msg_t *msg_update_open_freq_7( Instance_t inst, L2_ID L2_id, unsigned int NB_free_ch, CHANNEL_T *fr_channels, Transaction_t Trans_id);
msg_t *msg_update_SN_occ_freq_5( Instance_t inst, L2_ID L2_id, unsigned int NB_chan, unsigned int *occ_channels, Transaction_t Trans_id);
//mod_lor_10_04_27--*/
#ifdef __cplusplus
}
#endif
#endif /* RRC_MSG_H */
Reference in New Issue View Git Blame Copy Permalink